
Beginner’s Guide 
to the Sun Workstation 




o .-..-.-___- 

Sun Microsystems, Inc. • 2550 Garcia Avenue • Mountain View, CA 94043 • 415-960-1300 











o 



o 






Beginner’s Guide 
to the Sun Workstation 



Sun Microsystems, Inc. « 2550 G arcia Avenue • Mountain View, CA 94043 • 415-960-1300 

Part No: 800-1169-0! 
Revision A of 15 May, 1985 










Credits and Acknowledgements 


Material in this Beginner’s Guide to the Sun Workstation comes from a number of sources: Intro¬ 
ducing the UNIX System j Henry McGilton, Rachel Morgan, McGraw-Hill; UNIX for Beginners, 
Brian W. Kernighan, Bell Laboratories, Murray Hill, New Jersey; An Introduction to the C-Skell, 
William Joy, University of California, Berkeley; An Introduction to the Bourne Shell, S. R. 
Bourne, Bell Laboratories, Murray Hill, New Jersey; Mail Reference Manual, Kurt Shoens, 
revised by Craig Leres; How to Read the Network News, Mark. R. Horton, Bell Telephone 
Laboratories, Columbus, Ohio; and A Dial-Up Network of the UNIX Systems, D. A. Nowitz and 
M. E. Lesk, Bell Laboratories, Murray Hill, New Jersey. These materials are gratefully ack¬ 
nowledged. 


Trademarks 


Sun Workstation, and the combination of Sun with a numeric suffix 
are trademarks of Sun Microsystems, Inc. 

UNIX, UNIX/32V, UNIX System III, and UNIX 
System V are trademarks of Bell Laboratories. 

Ethernet is a trademark of Xerox Corporation. 


Copyright ® 1985 by Sun Microsystems Inc. 

This publication is protected by Federal Copyright Law, with all rights reserved. No part of this 
publication may be reproduced, stored in a retrieval system, translated, transcribed, or transmit¬ 
ted, in any form, or by any means manual, electric, electronic, electro-magnetic, mechanical, 
chemical, optical, or otherwise, without prior explicit written permission from Sun Microsystems. 





Revision History 


Date Comments 

19 November 1984 Alpha 2.0 release of this Beginner’s Guide to the Sun 
Workstation. 

15 April 1985 2.0 release of this Beginner’s Guide to the Sun Worksta¬ 

tion. 












Preface — Part One 


Welcome to the Sun Workstation. This manual provides a tutorial introduction to teach you the 
basic tools you need to use the system. We assume that you are a first-time Sun system user 
with some knowledge of an operating system, a terminal keyboard, and a text editor. We pro¬ 
vide explanations and exercises for learning to use the Sun system and Sun Workstation in par¬ 
ticular, however, most of the information is also applicable to using UNIX on ASCII terminals. 

If you already know something about UNIX, much of this material will look familiar, but its 
organization may be somewhat foreign. This format provides exercises for learning to use the 
system and does not explain the internals of the commands and programs. For more in-depth 
information on the Sun system and the UNIX operating system in general, there is a plethora of 
Sun documentation and literature, which is listed in the appendix. We refer to these manuals 
from time to time in this tutorial to draw you a roadmap of where to go from here with your 
education. 

After reading Part One of the Beginner’s Guide to the Sun Workstation, you wil have the basic 
tools you need to learn to use the Sun system. Part Two provides information on how to use the 
Shells, the mail facility, and the network news. Also included is a glossary and an annotated 
bibliography. 

The chapters in Part One are: 

1. Getting Started — Explains how to log in, the UNIX system file directory structure, how to 
use some basic system commands, and how to log out. 

2. Working With Files — Describes commands for manipulating your files. 

3. Using The Shell — Instructs you how to use the Shell commands and SunWmdows to make 
your work easier. 

4. Creating and Editing Text Files — The ‘vi’ Editor — Provides instructions on the most use¬ 
ful editor commands. 

5. Printing and Formatting Documents — Explains how to use the most useful text formatters 
and macro packages and how to display and print document copies. 

6. Communications — Introduces the communication facilities and describes how to use the 
mail system, how to talk to users on other systems, and how to use your local network. 

You should have a couple of other documents with you for easy reference as you begin. The 
most important is the Commands Reference Manual ; it’s often easier to tell you to read about 
something in the Commands Reference Manual than to repeat its contents here. The Com¬ 
mands Reference Manual also lists all the manuals supplied with the Sun Workstation. The 
other useful document is the Editing and Text Processing on the Sun Workstation, which 
explains how to use the text formatters and the vi editor. 
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Chapter 1 


Getting Started 


Sit down at your Sun Workstation. To use this tutorial, do the exercises and then experiment 
with the suggested options. Look up the commands in the Commands Reference Manual to get 
an idea of their additional capabilities. If you don’t get a desired response, poke around with the 
available options and commands until you do. Don’t be afraid to sample other commands 
described in the Commands Reference Manual; experimenting will quickly teach you how to 
work your way around the system. 


1.1. Logging In 

Examine the workstation screen. Since every system has a name, your screen displays something 
like 


tutorial login: 

where tutorial is the system’s name or hostname. Your installation may have a naming theme, 
such as naming all systems after planetary bodies, but for our purposes, let’s use the hostname 
tutorial. It’s important to remember your system’s hostname and the names of your colleagues 
so you can communicate with them and share files over the network. 

To begin, you also need a login name (also known as an account), which your system administra¬ 
tor sets up for you along with your system. To set up your own account or add a user, refer to 
the adduser command in the Commands Reference Manual. 

Be aware that the Sun system has a strong orientation towards lower-case characters and makes 
a definite distinction between upper and lower case. Type your name in lower case if possible — 
if you type in upper case, the Sun system assumes your terminal can^t talk lower case and so 
talks at you in upper case from here on. Sun system commands are almost always in lower case. 
If we begin a sentence with a command name in this manual, the first letter is capitalized as a 
courtesy to English. 

After you have typed your login name, and pressed the RETURN key, the system prompts you for 
a password if your account is set up with one. For example, your screen looks like: 

tutorial login: evan 
Password: 

when it is waiting for your password. Type your password and press RETURN. The system 
doesn’t display or echo your password, nor does the cursor even move as you type. This keeps 
your password secret from anyone who is looking over your shoulder. If you don’t have a pass¬ 
word, typing your login name and pressing RETURN gets you straight onto the system. If you 
make a mistake typing in your login name, press the DEL key. It backs up over your mistake one 
character at a time. Retype the correct characters. You can also simply press the RETURN key 
several times until you see the ’tutorial login:’ prompt again and start over. If you mistype your 
password, you see the same message as if you had mistyped your login name: 
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tutorial login: evan 
Password: 

Login incorrect 
tutorial login: 

Simply retype your login name and password to log in. 

You know you’ve logged on successfully when the system displays some messages and then 
displays a ready prompt. The display is either: 

tutorial login: evan 
Password: 

Last login: Mon Jul 18 07:50:22 on ttypO 

Sun UNIX 4.2 UNIX (Release 1,1.1) ( SUN) #4:Fri Jan 11 00:20:28 PST 1985 

tutorial% 


or 

tutorial login: evan 
Password; 

Last login: Mon Jul 18 07:50:22 on ttypO 

Sun UNIX 4.2 UNIX (Release 1.1.1) ( SUN) #4:Fri Jan 11 00:20:28 PST 1985 PDT 1983 

$ 

The and ‘$’ prompts indicate that the UNIX command interpreter, the Shell, is waiting for 
you to type commands at it. There are two versions of the Shell, the C-Shell and the Bourne 
Shell. Which character you get as a prompt {% or $) depends on which Shell is listening to you. 

We use the C-Shell, whose prompt is the sign in all our examples, but refer to it simply as 
the ‘Shell’ for simplicity’s sake. The Bourne Shell’s prompt Is the ‘$’ sign. The Sh^ls are 
described in the chapter Using the Shell and in more detail in Part Two of this manual. You can 
also refer to the Commands Reference Manual for the Sun Workstation pages on csh for the G- 
Shell and on sh for the Bourne Shell. 

Now try the following; at the ‘tutorial^’ prompt, type: 

tutorial% echo Hello there. 

Hello there. 
tutorial% 

Don’t forget to press RETURN (also called a carriage-return) after the command, or nothing will 
happen. If you think you’re being ignored, press RETURN, and something should happen. We 
won’t mention this again, but don’t forget to press RETURN at the end of each line. 

The first word you typed to the ‘tutorial^’ prompt on the command line is the Sun system com¬ 
mand echo. Echo does what it says, it ‘echoes’ or displays whatever follows it. ^en you type 
something to the ‘tutorial^’ prompt, the first word is always a command, which is also called a 
program. At this point, you are asking the Shell to look for that command and execute it. 

Now substitute your name in place of yourname in the example below: 

tutor la 1% echo Hello yourname 

Hello . . . 

tutorial^ 

Always separate a command from whatever follows by a space. Now try: 
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tutorial% echo This Is fun. 

This is fun. 
tutorial% 

These are very simple examples. What follows a command is an argument. Often this argument 
is the name of a file or filename, but in the simple example above, it’s merely some text. 

If you want to compile a program written in the C programming language, for instance, you 
type: 

tutorial% cc data.c 
tutorial% 

Here the command is cc, the C compiler program. The argument to cc is a file called data.c, 
containing the program’s source text. 

You can name a file almost anything you want, but limit yourself to alphanumeric characters, 
the underscore character ’J, and the period Other characters such as the asterisk (*), slash 
(/), and question mark (?) have special meanings when the Shell reads them. These special char¬ 
acters called metacharacter are described later. 

There is one more thing that you can type on the command line after the ‘tutorial^’ prompt. 
This is called an opfioti or flag argument. Type it after the command, but separate the two by a 
space. Flag arguments modify the command. For example, if you want to suppress the load 
phase of the compilation of your program data.c and produce an object file, you type the cc com¬ 
mand with the — c option: 

tutorial% cc —c data.c 
tutorial% 

Sun system commands usually have several options. 

Here’s a good opportunity to open up the Commands Reference Manual to learn more about 
commands and about this important manual which contains information on most of the com¬ 
mands used in this tutorial. Turn to the cc pages and glance through them. You first see NAME, 
which gives you the command name as you type it at the Shell prompt 'tutorial^' and a brief 
phrase describing what the command does. Here, you see that cc is the compiler. ’ Next you 
see the SYNOPSIS, which shows the command line format and all the options. Yes, there are 
plenty of options for the C compiler. Most commands do not have this many however. 

Following is the DESCRIPTION, which explains in more detail what the command does. OPTIONS 
lists and describes the flag arguments. The remaining entries, EXAMPLE, FILES, SEE ALSO, DIAG¬ 
NOSTICS and BUGS provide additional information. 

If you’re interested in the wealth of information that the Commands Reference Manual pro¬ 
vides, turn to the front of that manual and read on about the Sun system manuals in general to 
become familiar with the other reference sources. 

Note that important terms and command names in the text of this tutorial are printed in italics, 
cc for example, and options in bold, like —c. In the exercises, bold face type like this indi¬ 
cates what you should type at your workstation. 

In general, when you type characters to the Sun system, they are gathered up until you type 
RETURN or a newline (also called LINEFEED). Up to the point you type RETURN, you have the 
opportunity to correct typing mistakes — you can back up over characters or words, or you can 
delete the entire line typed so far and start over. Once you have typed a RETURN, though, the 
line is passed on to whatever program you asked for (or maybe none at all if you misspelled the 
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program’s name). 

If you make a mistake typing the command name, and refer to a non-existent command, you will 
be told. For example, type ‘whom’: 

tutorial% whom 
whom: not found 
tutorial% 

Clearly, ‘whom’ is not a command. Of course, if you inadvertently type the name of some other 
command, it will run with more or less mysterious results. 

The Sun system handles the keyboard and screen in full-duplex — it has full read-ahead, meaning 
that you can continue typing even while the system is displaying output on the screen. Of course, 
this means that what you type in as input is all mixed up with what the system displays — this 
may or may not bother you. However, what you type is saved up and interpreted in correct 
sequence. 

Try on6 more command; type the who am i command: 
tutorial% who am i 

tutorial!evan console Jan 11 14:19 

tutorial% 

The first name, ‘tutorial,’ is the system hostname; the second is the user’s login name, ‘evan’ in 
this case. 

Briefly, what’s happening when you run a program on the Sun system by typing the command 
name and pressing RETURN is this: the executing program takes input or data and produces out¬ 
put or results. A program usually expects to read the input from your keyboard, which is called 
the standard input, and the program usually writes its output to your workstation called the 
standard output. You can change these standards by redirecting the input and output to come 
from and go to other places, such as files, line printers, and so. This is explained in Ustng the 
Shell. 


1.2* What to Do If Something Goes Wrong 

Sometimes your system may not respond correctly. Here are two brief sections on what to do. 


1.2.1. Special Keys and Control Characters 

If you make a typing mistake, and see it before you press RETURN, there are several ways to 
recover using the following keys and control characters. You can also use some of these charac¬ 
ters to start and terminate programs. Glance over the list now to become familiar with them. 


Galled the erase character, DEL^ backs up over and erases the previously typed character. Suc¬ 
cessive uses of DEL erase characters back to the beginning of the line, but not beyond. 

"U Called the 

kill character, "U erases the entire line you just typed.^ If the line is fouled up, type a 


^ On older keyboards, use the BACKTAB key as the DEL key. 
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"U and Hart over. 

'"W This wipes out the previous worrfyou typed. (A word is a sequence of characters del¬ 

imited by space(s) and/or tab(s).) 

"C aborts or interrupts a currently running program. Use "C to stop a long printout, 
for example. (Programs, like editors, can either ignore "C altogether or be notified 
when it is typed instead of being terminated.) 

This stops output from a running program. It is useful for preventing text being 
displayed from zipping off your workstation screen. 

'‘Q "Q resumes output from a program whose display was suspended with "S. 

*0 This throws output away without interrupting the program. 

The Quit character quits a program and saves an image of that program in a file 
called core. This is mostly used by programmers debugging programs. 

Tab Tabs are used freely in the Sun system source programs. If your terminal does not 

have the tab function, use the stty command (described in the Commands Reference 
Manual) to turn tab characters into spaces during output, and to be echoed as spaces 
during input. Tabs are set every eight columns. 

You can find out what the control characters are anytime with the stty command: 

tutorial% stty all 

new tty, speed 9600 baud; tabs 

crt 

erase kill verase rprnt flush Inext susp intr quit stop eof 

*? "U *W ^O '‘V ^Z/^Y -C ^S/^Q “D 

tutorial% 

Some of these, like "Z, are explained later on. 


l.S.2. Things That Go Bump in the Night 

Sometimes you can get into a state where your workstation or terminal acts strangely. For 
example, you may not be able to move the cursor, your cursor may disappear, there is no echo¬ 
ing of what you type, or typing RETURN may not cause a linefeed or return the cursor to the left 
margin. Try the following solutions: 

• First, type "Q to resume possibly suspended output, (You might have typed "S, freezing 
the screen.) 

• Another possibility is that you accidentally typed a NO SCRL key (also called SET UP/NO 
SCROLL on some terminals) on your keyboard. This also freezes the keyboard like typing 
a "S. Try typing "Q, which toggles you back to proper operation if you did indeed type 
the NO SCRL key in the first place. 

• Try typing "C to interrupt the currently running program. 


^ We use the convention whatever* to mean eontrol-wkatever — that is, hold down the CONTROL (or 
CTRL) key while typing a whatever character. meant hold down the CONTROL key while typing either ‘d* 

or 
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• Next, try pressing the LINEFEED key, followed by typing ‘reset’, and pressing LINEFEED 
again. 

• If that doesn’t help, try logging out and logging back in (see Logging Out). If you are 
using a terminal, try powering it off and on to regain norma! operation. 

1.3. Changing Your Password — the ‘passwd’ Command 

Fasswd is the command that changes your password or installs one for you if you don’t already 
have one. Passwd is interactive so that when you type passwd, it prompts you for input as fol¬ 
lows: 

tutorial% passwd 
Changing password for evan 
Old password: ixzzxz 
New password: zzzzzz 
Retype new password: zzzzzz 
tutorial% 

The system doesn’t echo what you type (shown by the x’s and z’s above), but it does ask you to 
type your new password twice to prevent typographical accidents and to provide better security. 
You will have to provide a password at least 16 characters unless you are persistent. 


1.4. Logging Out 

When you have finished your login session, there are several ways to log out. One way is to use 
the logout command: 

tutorial% logout 
tutorial login: 

You can type an end-of-file indication, "D (the EOF character). Your system responds: 

tutorial% (^D) logout 
tutorial login: 

Finally, you can also change users directly with the login command and another login name: 

tutor ial% login jerry 
Password: 

Last login: Mon Jul 18 07:50:22 on ttypO 

Sun UNIX 4.2 UNIX ( Release 1.1.1) ( SUN) #4: Fri Jan 11 00:20:28 PST 1985 

tutorial% 

Try these logout methods now. 

Note that if you are using a terminal, it is usually not sufficient just to turn off the terminal to 
log out. Most Sun systems do not use a time-out mechanism, so you’ll still be logged in unless 
you logout explicitly. 
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1,5. What is the Shell? 


As discussed earlier, after you log in and the ‘tutorial%’ prompt appears, a utility program called 
the Shell listens to what you type. In general, what you type to the Shell is a command line. A 
command always consists of the command name, such as the cc which compiles C programs. 
This is always the first thing on the line. This command name can be followed by optional argu^ 
ments, such as the —c option or a filename. A command’s arguments are separated from the 
command, and from each other, by spaces andjor tabs. The Shell searches for the command in 
several well-known places, starts up the command, and passes the arguments on to it. When the 
command has completed its job, the Shell regains control and again listens to what you type. 

Most commands are simply executable programs that the Shell looks for, but some commands 
are ‘built-in’ to the Shell, and the Shell interprets such commands directly. The Shell has many 
other capabilities, which are detailed in the user’s manual in the csh (C-Shell) and sh (Shell) 
entries. These are the two main Shells that you can run. 

The Shells are different for all but the most simple terminal usage. For instance, the C-Shell has 
history and alias features, which greatly enhance its power when used interactively. The C-Shell 
also supports a set of job-control facilities. See the reference material on Shells in Part Two for 
more detailed information. 


1.5.1. Login Profile 

When you log in to the Sun system, you are logging in to the C-Shell. The Shell looks for files 
called .login and .cshrc. If there are such files in your home directory, (described later) it runs 
any commands it finds in them. 

You only execute the .login file when the Shell is called up as part of the process of logging in. A 
sample .login file is: 

setenv EXINIT ’set noai wrapmargln=8' 

set path=(. / /bin /usr/bin /usr/local /usr/ucb /usr/hosts) 
set mall=(/usr/spool/mail/$USER) 

We won’t explain now what all these entries mean; see Using the C-Shell in Part Two for details. 

The file .cshrc is executed any time the Shell is invoked; for example, when you start or fork a 
new Shell. You’ll find that “re” is a part of several such filenames, .mailrc for example. The 
“rc” is related to the phrase “run command,” and is used for any file that contains start-up 
information for a command. A sample .cshrc file is: 

if (! $?proii^t) exit 
set history=36 
alias If Is -F 
alias cursor echo ’“[[s' 
alias pq ’Ipq —P’ 

alias tutorial cd supplements/tutorial 

The history and alias entries are described later. Again, see Using the C-Shell for more details. 
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1,6. The File System 


Sun system files are arranged in a hierarchy of directories. This hierarchy resembles an inverted 
tree structure: the file system begins at the root directory and branches to the limits of the avail¬ 
able mass storage. Root is the name of the directory at the ‘beginning’ of the file system. It is 
represented by a slash Do not be confused by the two meanings of it’s both the name 
of the root and a separator in filenames. Root contains references to files and subdirectories 
which contain other files and subdirectories and so on. Each directory is thus like a node on the 
tree — directories contain files (which contain data) and subdirectories (which contain files). 
Here is a picture which makes this clearer: 



Figure 1-1: File Hierarchy Structure 

You can either move to another directory to work on the files held there, or you can gain access 
to those files from where you are, but you need to know where you are and what the direction or 
pathname is to the directory you want. If you are in /ttsr for example, and want to work on a 
file in evan, then you need specify only the relative pathname as the directories are on the same 
branch. Look at this as a sort of ‘how to get there from here’ situation. If you are in usr and 
want to gain access to something in /bin, you need to indicate the absolute or full pathname, 
which specifies ‘how to get there from the system root.’ 

You can always find out where you are in this structure. Use the pwd (print working directory) 
command and type: 

tutorial% pwd 

/usr/evan/lntro 

tutorial% 

to get your current or working directory. Here we are in /usr/evan/intro. There is a special 
notation that indicates, among other things, the current directory. This is the or ‘dot’. Two 
dots means the parent directory, that is, the directory that the current directory (‘.’) is a 
subdirectory of. This convention is constant wherever you are in the directory hierarchy. 

The initial slash ‘/’ in the response to the pwd command above names root, and successive 
slashes separate directory names. Here the current working directory is intro, which is a sub¬ 
directory of the directory evan, which is in usr, which is in ‘/’. The pwd command displays the 
full pathname to your directory. 

Your system administrator sets up your account by creating a directory, normally using the same 
name as your login name. This is called your home directory. Everytime you log in, your work¬ 
ing directory will be set to your home directory. You own your home directory. This means you 
have full permission to read, write, or destroy its contents. You can also create new files and 
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subdirectories within your home directory as needed, and do with them as you please. Access to 
files that others own is carefully controlled. 

There are two kinds of directories, system directories and user directories. System directories 
contain files and subdirectories that apply to the whole system. You and your fellow users can 
make user directories as needed as we show below. We describe how to do this later. For exam¬ 
ple, earlier you saw a user directory for Evan, /usr/evan. There can be lots of user directories; 
it depends on how big the system is and on how many people can use it. You can have 
/usr/henry for user Henry, and Insr/gang^ for a particular project’s user directory, for example. 

There are also system directories, such as /6m, which holds most of the executable system com¬ 
mands, /etc which contains system maintenance commands, and /usr, which contains other 
directories. For instance, your login name, encrypted password, and other information are con¬ 
tained in the passwd file in the /etc system directory. 

That’s enough detail — let’s move on to how you can use files and directories. 


1.6.L Changing to Other Directories with 

To move to other directories, use the cd (change working directory) command. If you’re in your 
home directory now at /usr/evan, and you want to change to the /etc directory, type: 

tutorial% cd /etc 
tutorial% 

You’ve moved to /etc. If you then check your working directory with pwd, you’ll see: 

tutorial% pwd 
/etc 

tutorial% 

A cd command without any argument always returns you to your home directory. So if you get 
lost, type cd to get home: 

tutorial% cd 
tutorial% pwd 
/usr/evan 
tutorial% 

And to change to the directory directly above the one you are currently in, type: 

tutorial% cd .. 
tutorial% 

Try changing to some of the other directories noted above, such as /6m. 


1.6.2. Listing Your Files—the *ls^ Command 

You can see what a directory contains tising the Is or ‘list’ command. See what files are con¬ 
tained in the root directory ‘/’. Type the Is command: 
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tutorial^ Is / 

bin etc mnt sys usr 

boot lib pub testfile vmunix 

dev lost+found stand tmp 

tutorial% 

You see several columns of files and directories. Try changing to some of these directories and 
using Is to list the contents. 

Now change back to your home directory and use Is to list files there. 

tutorial% cd 
tutorial% Is 
tutorial% 

You don’t have any files in your home directory so Is doesn’t list anything. There are, however, 
some ‘hidden’ files, which the Is command with the —al option reveals. First try: 

tutorial% Is — al 
total 14 

drwxr-xr-x 2 evan 32 

drwxr-xr-x 12 root 240 
tutorial% 

The —a option lists ‘all’ files. The -1 asks for a ‘long’ listing, for without it, only the filenames 
and subdirectory names are listed. Details on what all the parts of the —I listing mean are pro¬ 
vided later. You’ll also notice here that you can combine flags as a sort of shorthand. 

Again, the is your home directory, and the your parent directory or /usr. 

There is another variant Is —F, which marks which files contain executable programs, which files 
are directories, and which files are symbolic links (link a file or directory to another file or direc¬ 
tory). Try listing the contents of the root directory with the —F option: 

etc/ mnt/ sys/ usr/ 

lib/ pub/ testfile vmunix® 

lost-hfound/ stand/ tmp/ 

An entry without any following mark is a simple file. Those entries marked with an asterisk sign 
are executable. Those marked with a slash character ‘/’ are directories and contain more files 
or subdirectories. Those marked with an ‘at’ sign are symbolic links. Note: Except on a 
client machine, vmunix should never be a symbolic link. 


tutorial^ Is —F / 

bin/ 

boot* 

dev/ 

tutorial% 


Mar 12 20:31 . 
Jul 7 15:22 .. 


I.6.S. Making Directories with 'mkdir' 

Let’s assume you now want to create some subdirectories to hold documentation and related 
memos for a customer demonstration of your new product. These will be user directories in 
/usr/evan. Return to your home directory and make sure you know where you are: 

tutorial% cd 
tut:orial% pwd 
/usr/evan 
tutorial% 


MO 
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Use the mkdir command to create (or ‘make’) directories for this project: 

tutorial% mkdir docs letters 
tutorial% cd docs 

tutorial% mkdir specs prlceJlst prod.announce 
tutorial% Is “1 
total 3 

drwxr-xr-x 2 evan 24 Aug 19 09:12 price-list 

drwxr-xr-x 2 evan 24 Aug 19 09:12 prod.announce 

drwxr-xr-x 2 evan 24 Aug 19 09:12 specs 

tutorial% cd ../letters 

tutorial% mkdir meet.mln memos 

tutorial% Is —I 

total 2 

drwxr-xr-x 2 evan 24 Aug 19 09:15 meet.min 

drwxr-xr-x 2 evan 24 Aug 19 09:15 memos 

tutorial% cd 
tutorial% 

The file system hierarchy here looks like: 


(root) 



meet.min memos specs price.list prod.announce 


Figure 1-2: Sample File Hierarchy 



L6.4‘ Removing Directories with 'rmdir' 

Use rmdir to remove directories. The directory must not contain any files or subdirectories if it 
is to be removed. For example, try to remove the letters directory: 
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tutorial% rmdir letters 

rmdir: letters: Directory not empty 

tutorial% 

What happened? The letten directory stili has subdirectories in it. Before you can move it, you 
must delete all files or subdirectories under it. Remove them like this: 

tutorial% rmdir letters/meet.mln letters/memos letters 
tutorial% 

Rmdir also lets you know if you try to remove a non-existent directory: 

tutorial% rmdir void 

rmdir: void: No such file or directory 
tutorial% 

You can also use rm -r to delete directories: 

tutorial% rm -r letters 
rm -r works exactly the same as rmdir. 


1.6.5. Copying Files with ‘cp' 

To make a copy of another file, use the cp (copy) command on the /etc/hosts.equiv file: 

tutorial% cp /etc/hosts.equlv hosts.machines 
tutorial% 

This copies kosts.equiv file in the /etc directory into a file called kosts.machines in your current 
working directory. Use this simple command to make as many copies of any file you want. 

Check your current working directory with the Is command to see what it now contains. 

tutorial% Is —1 
total 6 

drwxr-xr-x 5 evan 512 Aug 19 09:12 docs 

-rw-t 1 - 1 evan 480 Aug 19 09:23 hosts.machines 

tutorial% 

Remember the order of the cp command: cp copies the first file (or ‘argument’) to the last: 

tutor ial% cp this that 
tutorial% 

To copy the same named file into your own directory, mention the filename twice: 

tutor ial% cp /etc/hosts.equlv hosts.equlv 
tutorial% 

This puts a copy of the file called kosts.equiv into the current directory. 

If the second argument is an existing directory, you can use cp to copy the file named as the first 
argument into that directory and retain the same filename. It’s a little faster too. 

tutor ial% cp /etc/hosts.equlv • 
tutorial% 

This copies /etc/kosts.equiv into your current directory; the ‘dot’ ( . ) again stands for the 
current directory. 


1-12 


Revision A of 15 April 1985 



You can copy a file into another file in your current directory or into one of your subdirectories 
as follows: 

tutori a 1% cp /etc/hoBts.equiv docs 
tutorial% 

Or you can copy as many files as you need into a directory: 

tutorial% cp docs/specs docs/price.llst . 

tutorial% Is —1 

total 


drwxr-xr-x 

5 evan 

512 

Aug 

19 

09:28 

docs 

-rw“i- 1 - 

1 evan 

480 

Aug 

19 

09:27 

hosts.equiv 

-rw-i—I— 

1 evan 

480 

Aug 

19 

09:23 

hosts.machines 

-rwxr-xr-x 

1 evan 

24 

Aug 

19 

09:29 

price.list 

-rwxr-xr-x 

1 evan 

24 

Aug 

19 

09:29 

specs 


tutorial% 

Notice that in the above example, the first two arguments are files and that the last argument is 
the destination directory. 

Cautions: 

There isn^t any warning if you try to copy a file to another that already exists. The existing 
file is written over, and you lose that version. 

If a file is protected from being written on for security reasons, or if you try to copy into a 
non-existing directory, you see the message: 

tutorial% cp notes intro/lessons 
cp: cannot create intro/lessons 
tutorial% 

And if for security reasons, you do not have read permission on the source file, write permis¬ 
sion to the directory, or if again, the source file or directory does not exist, you see: 

tutorial% cp data/today tomorrow 

Permission denied. 

tutorial% 


1.6.6. Moving and Renaming Files with 'mv* 

To move files and directories from one place in the file system to another, use the mv (move) 
command. Mv renames a file. Moving differs from copying in that the original file disappears. 

Try using mv as follows: 
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tutorial% 1b —1 


drwxr-xr-x 

5 

evan 

512 

Aug 

19 

09:28 

docs 

-rw-i- 1 - 

1 

evan 

480 

Aug 

19 

09:27 

hosts.equiv 

-rw-i- 1 - 

1 

evan 

480 

Aug 

19 

09:23 

hosts.maehlnes 

-rwxr-xr-x 

1 

evan 

24 

Aug 

19 

09:29 

price.list 

-rwxr-xr-x 

1 

evan 

24 

Aug 

19 

09:29 

specs 

tutorlal% mv 

hosts.equiv 

hosts 





tutorlal% Is ■ 

-1 







drwxr-xr-x 

5 

evan 

512 

Aug 

19 

09:28 

docs 

-rw-i —1 - 

1 

evan 

480 

Aug 

19 

09:27 

hosts 

-rw-i —1 - 

1 

evan 

480 

Aug 

19 

09:23 

hosts.maehlnes 

-rwxr-xr-x 

1 

evan 

24 

Aug 

19 

09:29 

price.list 

-rwxr-xr-x 

1 

evan 

24 

Aug 

19 

09:29 

specs 


tutorial% 

The file ho^ts.equtv has been renamed hosts. Caution: 

If you move a file to a name that already exists, the second file contents are removed without 
warning: 

tutorial% mv hosts hosts.machines 
tutorial% Is -1 


drwxr-xr-x 

5 

evan 

512 

Aug 19 

09:28 

docs 

-rw-i— 1 — 

1 

evan 

480 

Aug 19 

09:27 

hosts.machines 

-rwxr-xr-x 

1 

evan 

24 

Aug 19 

09:29 price.list 

-rwxr-xr-x 

1 

evan 

24 

Aug 19 

09:29 

specs 


tutorial% 


If the target file is write-protected, mv asks you if you really want to write over the file. If you 
respond with y (yes), the file is moved. Otherwise, nothing happens. 

To move a file from one directory to another, make the second argument to mv the name of the 
destination directory, if the destination directory exists: 


tutorial% Is —1 
total 

drwxr-xr-x 5 evan 512 Aug 

-rw-i- 1 - 1 evan 480 Aug 

-rwxr-xr-x 1 evan 24 Aug 

tutorial% mv hosts.maehlnes docs/specs 
tutorial% Is —1 
total 

drwxr-xr-x 5 evan 512 Aug 

-rwxr-xr-x 1 evan 24 Aug 

tutor ial% Is -I docs/specs 
total 1 

-rw-r--r-- 1 evan 

tutorial% 


19 09:28 docs 

19 09:27 hosts.maehlnes 

19 09:29 specs 


19 09:28 docs 
19 09:29 specs 


480 Aug 19 09:27 hosts.maehlnes 


You can move more than one file at a time into a destination directory, just be sure to make the 
destination directory the last argument on the command line. 
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You can also move an entire directory to another name, but unlike files, you can only move 
directories if the second name does not already exist. See the Commandf Reference Manual on 
mv for details on all the 
facilities. 

You can’t move or rename a file that doesn’t exist. You’ll see the message: 

tutor la 1% mv Illusion delusion 

mv: cannot access illusion 
tutorial% 


1,6.7. Removing Files with the Wm' Command 

The rm command removes files from a directory. See what is in one of your directories, and 
remove a file of little importance: 

tutorial% cd docs 
tutorial% Is —1 docs 
total 3 


“rvr-r--i— 

1 

evan 

480 

Aug 19 

09:28 

hosts.equiv 

drwxr-xr-x 

2 

evan 

24 

Aug 

19 

09:12 

price.list 

drwxi—xr-x 

2 

evan 

512 

Aug 

19 

09:45 

specs 

tutorial% rm hosts.equlv 








tutorial% Is —1 docs 








total 2 








drwxr-xr-x 

2 

evan 

24 

Aug 

19 

09:12 

price.list 

drwxr-xr-x 

2 

evan 

512 

Aug 

19 

09:45 

specs 


tutorial% 

Again, like the cp command, you can work on more than one file at a time. And if any file is 
write-protected, rm asks you whether you really want to remove a file. Responding y tells rm 
‘yes,’ and rm removes the file. Typing n or simply typing the RETURN key prevents rm from 
removing the file. Even if you own the file and have read permission on it, you cannot remove a 
file from a directory if you don’t have write permission on that directory. 

If you are worried about removing files that you really don’t want to remove, use the —i option 
to rm to get an ‘interactive’ prompt on every file. 

There is also the —f option that ‘forces’ the rm command to remove a file, even if it is write- 
protected. 

With —r (recursive) option, the rm command searches down the directory tree, removing all files 
it finds. When a subdirectory is empty, rm then removes that subdirectory. This command does 
this for every file in every subdirectory (and so on) that it finds in the specified directory. 

Make copies of some of the files in /u«r or /etc and try these options. Use the h -F command to 
copy text files, not executable files or directories. 

Caution: 

There are several special characters called “metacharacters” in the Sun system. We’ll 
describe them in more detail later, but for now be careful about using the metacharacter 
with ”rm”, and especially with the —r recursive option. 
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tutorial% rm —r • 
tutorial^ 

removes EVERYTHING from the current directory on down as does the rm — r . command, so 
be careful! 

Trying to remove a non-existent file results in: 

tutorial% rm nobody.home 
rm: nobody.home non-existent 
tutorial% 

You may have a file with non-ASCn characters in its filename, perhaps from a typographical 
error. Try rm —i or rm —r to remove it. 


1*7. Security 

If you are worried about all the freedom that the Sun system provides to copy files, change direc¬ 
tories, and such, rest assured that it also supplies a security system to control access to files and 
directories. For every file and directory, there are three classes of users who may have access, 
and for each of these classes, there are three ‘permissions,’ allowing or prohibiting access to a 
particular file. 

The three classes are: 

1. Owner — the person who created the file. 

2. Group — the group of users who share ownership of a file. (This is set up in the 
/eic/passwd file along with your login name and in the fetc/group file.) 

3. Public — all other system users. 

For each of these classes, the three permissions are: 

1. Read — allows reading the file. 

2. Write — allows changes to the file. 

3. Execute — allows listing files in a directory, and execution of programs and Shell scripts. 
Consider some of the files and directories from before: 


drwxr-xr-x 

5 

evan 

512 

Aug 19 

09:20 

docs 

-rw-i- 1 - 

1 

evan 

480 

Aug 19 

09:27 

hosts.machines 

-rwxr-xr-x 

1 

evan 

24 

Aug 19 

09:29 

specs 


Here’s how you interpret all that stuff at the beginning of the lines. Consider the doc6 directory: 

drwxr-xr-x 5 evan 512 Aug 19 09:28 docs 

The ‘drwxr-xr-x’ order shows ‘user, group, public.’ The first ‘rwx’ belongs to the user ‘evan’ who 
has re ad-write-execute permission. The second ‘r-x’ belongs to the ‘group’ which has read- 
execute permission for the file. The third ‘r-x’ belongs to the ‘public’ which also has read- 
execute permission. Hyphens indicate the absence of a permission. The leading ‘d’ indicates 
that it is a directory. 
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1.7.1. Changing File Permissions with *chmod^ 

Suppose you need to change the permissions on a file or directory so others can access them to 
do work. The chmod command changes those permissions or the ‘mode’ of the file. There are 
four common modes that set the permissions. The following numbers are based on the octal 
number format. (Read more about chmod in the Commands Reference Manual if there doesn’t 
seem to be any rhyme or reason.) 

• 644 indicates ‘-rw-r—r--’. The owner can read and write the file, but everyone else can 
only read it. 

• 755 indicates ‘rwxr-xr-x’. The owner can read, write, and execute the file, and everyone 
else can read and execute it. This is the default permission. Your system creates files 
with these permissions unless you give it other instructions. This permission lets you 
have control over your files and lets others ’look but not touch’. You can imagine why 
you might not want your fellow users writing changes to your files without your permis¬ 
sion. 

• 600 indicates ‘rw-’ for a file (use 700 for a directory). The owner can read and write 

the file, and everyone else has no access. 

• 444 indicates ‘r—r—r--’. Everybody can only read the file. 

Suppose you have some directories like ‘evan’ above, and you decide that only you should be 
able to read and write the docs directory, while everyone else cannot do anything. As it is now, 
the permissions are: 

tutorla1% U —I 

drwxr-xr-x 5 evan 512 Aug 19 09:28 docs 

tutorial% 

Using the chmod command with the ‘700’ permission, type: 

tutor!a 1% chmod 700 docs 
tutorial% Is —1 

drwx- 5 evan 512 Aug 19 09:28 docs 

tutorial% 

The ‘755’ permission is the default. 

Caution: 

This directory must have execute permission if you want to access it. 

You can’t change the mode of a file that doesn’t exist, nor can you change the mode of a file that 
you don’t own (remember ownership is indicated by the login name, ‘evan’ in the example 
above). 


I.8. Finding Out What Is Going On In the System 

You now have a basic understanding of your personal directory. Let’s take a step outside and 
see what the system can do for you. 
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L8.1. Who Is Logged On — the 'who* Command 

See who is currently logged in with the who command: 
tutorial% who 

evan console Jan 16 09:11 

smith ttypO Jan 16 09:25 
tutorial% 

The first entry is the user’s login name, the second entry is the system’s idea of what terminal 
the user is on, and the date and time is when the user logged in. 


1.8.2, What is the Date and Time — the *date* Command 

Another useful command is the date command. Try typing: 
tutorial% date 

Fri Aug 19 10:15:08 PST 1985 
tutorial% 

and you get back not only the day and date, but also the time (that is, the system’s idea of what 
time it is). 

1.8.3. What Is the System Doing — the 'ps* Command 

Because this is a multi-tasking system, you can run several processes at once. (We’ll explain how 
to do this in Using the Shell) When you do execute several commands at one time, you may need 
to know how far along they are. Use the ps (process status) command for this: 

tutorial% pa 

PID TT STAT TIME CMD 

2025 02 R 0:01 ps 

tutorial% 

This lists the processes belonging to you. PID indicates the ‘process identification’ number, TT 
the terminal from which the process was started, STAT the state of the process, TIME the 
amount of computer time used so far, and CMD the command line that was typed to initiate the 
process. 

As you can see, there is one process in operation, the ps process. 

With the —X option, the ps command displays all your processes: 


tutorial% ps —X 

PID TT STAT 

TIME 

CMD 

2028 02 S 

0:05 

ps 

2029 08 S 

0:05 

—csh (csh) 

tutorial% 




Looking at the TT column, note that in our example, you are logged on twice, once on tty02 and 
once on tty08. Ps displays all processes associated with the user, not those associated with a par¬ 
ticular workstation or terminal. 

Also try the ps command with the —ax option, which tells about ‘all’ processes going on in the 
system. For example: 
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tutorial% ps —ax 


PID 

TT 

STAT 

TIME 

COMMAND 

0 

? 

D 

2:33 

swapper 

1 

? 

I 

0:20 

/etc/init - 

2 

? 

D 

0:08 

pagedaemon 



< etc. 

> 


5535 

CO 

S 

0:22 

—csh (csh) 

5696 

CO 

R 

0:03 

ps —ax 


tutorial% 


1.8.4^ Who's Doing What — the ‘w' Command 



If you get really nosey, try the w command to check whether there is anyone else logged in to 
your system and what that user is doing. Try this now and decipher the abbreviations using 
your knowledge of what the who and ps commands display. 


tutorial% w 



evan 

console 

Feb 15 

11:28 

evan 

ttypO 

Feb 15 

11:29 

evan 

ttypl 

Feb 15 

11:29 

evan 

ttyp2 

Feb 15 

11:35 

tutorial% 




Here, ‘evan’ is logged in to the ‘console’ and is running several shells within his window system. 

It’s also polite to run w before using write to write a message to someone (we explain this in the 
Communications chapter). Check what your colleague is doing first; it’s not nice to interrupt 
him in the middle of editing a file, for example. 


o 
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Chapter 2 


Working with Files 


This chapter explains how to view your text files and how to do simple operations on them. 
First, you need a file to play with. Step through the instructions to prepare the lusrflib!units 
system file for the exercises that follow. The /usrHib/units file converts units of measure and is 
something of a hodge-podge, but it’s interesting to glance through. The instructions do not pro¬ 
vide explanations of each command here, but you can always refer to the Commands Reference 
Manual if you’re particularly curious about something at this point. By the end of this tutorial, 
you will be able to look back at this sequence and understand each step. 

Remember: If you make a typing mistake, use the 2DEL key to back up and correct the error. 
You can also type RETURN to which the system will respond ‘Command not found’ or 
‘Unmatched’. You can then retype the command. 

1. Be sure you are in your home directory with cd: 

tutorial% cd 
t:utorial% pwd 
/usr/evan 
tutorial% 

2. Use the head command with the -30 line option on the /ust/ lib/units file, and redirect 
it to a file called start.here: 

tutor ial% head —30 /usr/lib/unltB > Btart.here 
tutorial% 

3. Use the tail command with the —30 line option on the /usr/lib/units file and append the 
results to the start.here file: 

tutor ial% tail —30 /usr/llb/units » Btart.here 
tutorial% 

4. Use the tr (translate) command to change tabs to spaces in the start.here file so the file 
is easier to work with. The sequence of keystrokes here is a little bit tricky; after the 
first apostrophe, type the TAB key. This jumps the cursor one tab space, and you can 
continue typing in the rest of the command line, putting spaces between the apos¬ 
trophes. Here you also create your practice file called playfile: 

tutorial% tr * * * * < start.here > playfile 

tutorial% 

5. Check your home directory with the Is command to see that the playfile is there. 

tutor ial% 1b 
playfile start.here 
tutorial% 

The original start.here file is there too. 


Revision A of 15 April 1985 


2-1 



Working with Files 


Beginner's Guide 


You are now ready to begin working with a file of text. 


2 . 1 . Paging Through a File with ‘more’ 

The more command reads one or more text files and displays the contents a screenful at a time. 
Try it on playfile, for instance: 

tutorial% more playflle 
/ dimensions 
m *a* 
kg *b* 
sec *c* 

< etc. > 
wey 40 bu 
weymass 252 lb 
--More--(47%) 

The ‘47%’ message informs you what percentage of the current file’s characters has been 
displayed so far. A 0% percentage may be displayed if you are looking at a very large file 
because more displays only integer percentages. 

To display one more line at the bottom of the screen, press the RETURN key. To see the next 
screenful, press the space bar. To see the next 11 lines, type ‘d’ or D. 

To terminate more, simply type ‘q’ for ‘quit’ and you return to the ‘tutorial%’ prompt: 

strike 2 bu 
surveyfoot british-ft 
surveyorschain 66 ft 
< etc. > 

Xunit 1.00202-13m 
k 1.38047-16 erg/degC 
--More--(97%) 

<q> 

tutorial% 

More has options that help you get to a specific line or text pattern in a file. For instance, to get 
to line 45 in the file playfile, type: 

tutor ial% more +45 playflle 
tablespoon 4 fldr 
teaspoon 4|3 fldr 
tesla weber/m2 

< etc. > 

weymass 252 lb 
Xunit 1.00202-13m 
k 1.38047-16 erg/degC 
tutorial% 

To start displaying text at the first line which contains a string, ‘circle’ for example, type: 
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tutor ial% more +/*circle’ playflle 
. . .skipping 

degree 1|180 pi-radian 
circle 2 pi-radian 
slug lb-g-sec2/ft 

< etc. > 

weymass 252 lb 
Xunit 1.00202-13m 
--More--(97%) 

This is one of the few instances of prefixing an option with a ‘+’. As you saw earlier, most 
options are prefixed with a 

There is another command, the cat command (for ‘concatenate’ or join), which also displays a 
file on the screen. However, if your file has more than one screenful of data (and yours does, as 
it has two workstation screens or 60 lines), it zips off the screen before you can see it. Try using 
cat now just to see what it does: 

tutorial% cat playfile 

< zip!! > 
tutorial% 

We simply mention cat here along with the other file viewing commands and describe its more 
useful capabilities later in Using the Shell. 


2*2. Browsing Through a File with ‘view’ 

With the more command, you can page through a file by typing the space bar or move through a 
file line by line by typing RETURN. When you want to scroll forward and backward through a 
file, use the view command: 

tutorial% view playfile 
/ dimensions 
m *a* 
kg *b* 

< etc. > 
span 9 in 

spat 4 pi sr 

"playfile* ' [Read only] 60 lines, 959 characters 

Use the following characters to move the screen: 

"■D scrolls down one half screen 
''U scrolls up one half screen 
'‘F moves forward one screenful 
*8 moves backward one screenful 

Remember, the means ‘Hold down the CTRL key while typing the letter.’ 

To exit or ‘quit’ viewing the file, type ESC:q!, which is echoed at the bottom of the screen and 
returns you to the ‘tutorial^’ prompt. 

Caution: 

Do not try any commands not mentioned here with view or you may get stuck in an editor 
and be unable to quit it. 
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You’ll see in Creating and Editing Files — The Vr Editor that the vi editor uses these same 
characters. 


2*3. Look at the First Few Lines of a File with ‘head’ 

When you need to check the first few lines of a file, use the head command. This is one of the 
commands you typed to make the playfile. Head gives you the first ten lines if you don’t specify 
how many you want. Here let’s specify the first three lines, for instance: 

tutorial% head —3 playflie 
/ dimensions 
m *a* 
kg *b* 
tutorial% 

Head also accepts a list of filenames and will then display the first few lines from each with a 
special header to indicate the filename. You have two files, playfile and start.here, so let’s use 
those. 

tutorial% head —4 playflie start.here 
==> playfile <== 

/ dimensions 
m *a* 
kg *b* 
sec *c* 

==> start.here < 

/ dimensions 
m 
kg 
sec 

tutorial% 

Here you have two separate files, showing the first four (if there are four) lines of each. Each file 
has a separate entry and the filename is enclosed in =—> <==» as shown. 

2.4. Look at the Last Few Lines of a File with ‘tail’ 

The tail command is similar to the head command, but displays the tail-end of the file. Again, if 
you do not specify a number, you see the last ten lines. For example, to see the last three lines 
of the file, type: 

tutorial% tall -3 playflie 
veymass 252 lb 
Xunit 1.00202-13m 
k 1.38047-16 erg/degC 
tutorial% 

Precede the number given to tail by a minus sign to indicate that the last x number of lines are 
to be displayed. If you precede the number with a plus sign, tail shows all the lines from that 
specified to the end of the file. Note that unlike head, tail does not work on more than one file 
at a time. 


*a* 

*b* 

*c* 
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tutorial% t^l +55 playflle 
tun 8 barrel 

water .2249112.54 kg/m2-sec2 
wey 40 bu 
weymass 252 lb 
Xunit 1.00202-13m 
k 1.38047-16 erg/degC 
tutorial% 


2.5. Counting Characters, Words, and Lines in a File with ‘wc’ 

When you need to count the lines of source code in a program or the number of words in a docu¬ 
ment, use the wc (word count) command. Try it now on your file. For example: 

tutorial% wc playflle 

60 147 959 playflle 

tutorial% 

Wc provides the number of lines, words, and characters in the file. If you only want one of the 
three counts, use the —I option to count lines, the —w option to count words, and the —c option 
to count characters. Try wc with the —w option to count the number of words: 

tutorial% wc -w playflle 
147 playflle 
tutorial% 

Play file has 147 words. 


2.6. Searching for Patterns in a File with ‘grep’ 

Grep searches one or more files for lines which contain strings of a certain pattern. Such lines 
are said to match the pattern. 

Grep looks for a pattern which consists of a fixed character string. It is also possible to describe 
more complex patterns, called ‘regular expressions,’ (Grep stands for ‘global regular expression 
print,’ if that helps.) 

To search for a character string, give grep a fixed character string. To find the string ‘ifich’ in 
the file, for instance, type: 

tutor la 1% grep inch playflle 
tutorlal% 

The ‘tutorial^’ prompt returns for the next command, indicating that there is no match in this 
case. 

Now try to find the string ‘mercury’ in the file. Type: 

tutor la 1% grep mercury playflle 
mercury 1.33322+5 kg/m2-sec2 
hg mercury 
tutorlal% 

This shows that there are two such strings in the file. 
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Or, if you are not sure which file contains the desired string, scan more than one file at the same 
time: 


tutorial% grep mercury playfile start.here 
p1ayfilo:mercury 1.33322+5 kg/m2-sec2 

playfile:hg mercury 

start.here:mercury 1.33322+5 kg/m2-sec2 

start.here:hg mercury 

tutorial% 

Here you see that grep labels ‘mercury’ with the name of the file in which the string is contained. 

If the filename is not important, suppress it with the -h (omit file header) option. Now consider 
the example as: 


tutorial% grep “h fu«» playfile start.here 
fuzz 1 

c 2.997925+8 m/sec fuzz 
au 1.49597871+11 m fuzz 
mole 6.022169+23 fuzz 
e 1.6021917-19 coul fuzz 
fuzz 1 

c 2.997925+8 m/sec fuzz 

au 1.49597871+11 m fuzz 

mole 6.022169+23 fuzz 

e 1.6021917-19 coul fuzz 

tutorial% 


This gives you several references to the string ‘fuzz’. 

When you want to find a specific string and not a lot of extraneous references, type it exactly as 
you want to find it. For instance, if you are generally interested in finding references to ‘survey’, 
type: 


tutorial% grep survey playfile 
surveyfoot british-ft 
surveyorschain 66 ft 
surveyorslink 66j100 ft 
tutorial^ 


You see three words containing the string ‘survey’. However, if you want to find the specific 
string ‘surveyorschain’, type that string: 

tutorial% grep surveyorschain playfile 

surveyorschain 66 ft 

tutorial% 


If the pattern you’re looking for contains spaces, ‘2 pi’, for example, surround it with quote signs 
( ’ ) so that it forms one argument. 

tutorlal% grep *2 pi* playfile 
circle 2 pi-radian 
tutorial% 

A space is used to separate arguments, so a pattern which also contains spaces must be enclosed 
in quotes. 

If you want to find all the lines except those that match the string, use the —v (for invert) 
option. We’ll leave this up to you to experiment with. 
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At times you want to find a string regardless of whether it is in upper or lower case. Use the —5 
grep option to ‘ignore case’. As the playfile is almost solely lower case, here’s an example of 
using grep with the —i option to find the string ‘bool’ in the file optionsw.c: 

tutorial% grep —! bool optionsw.c 
#define OPT_BOOL 1 

case OPT_BOOL: optb_destroy(ip->oi_data); 

struct optb_data 

optsw_bool(struct optionsw *optsw; int line, loft; char *label 
optsw_bool(struct optionsw *optsw; struct rect r; char * label; 

This finds all the lines containing ‘bool’ in either upper or lower case. 

Use the —n (number) option to show the line numbers of lines that match the string or pattern, 
for example: 

tutorial% grep —n fuss playfile 

15:fuzz 1 

17:c 2.997925+8 m/sec fuzz 
19:au 1.49597871+11 m fuzz 

20:mole 6.022169+23 fuzz 
21:e 1.6021917-19 coul fuzz 
tutorialJi 

This helps when you are using an editor or some other command to process the file using line 
numbers. 


Regular Expressions in Text Patterns 

To search for more complex strings than simple fixed character strings, give grep a pattern (or 
template) of the text to search for. For example, you may wish to express a pattern ndeaning 
‘find all words ending in ing,’ or ‘all 4-digit numbers appearing at the end of a line.’ When using 
grep, such a pattern or template is called a ‘regular expression,’ 

Grep uses certain characters called metacharacters that represent something other than them¬ 
selves and have a special meaning. Metacharacters help you define the pattern or regular 
expression. We describe these below with examples, but what you need to know now is that 
sometimes you may want to use these metacharacters to represent themselves. That is, if you 
want to find a string with a dollar sign ‘$’, you need to remove its special metacharacter 
significance. (‘$’ matches the end of a line.) To remove the special significance of metacharac¬ 
ters, precede them with the backslash ‘ \ ’ character. In this case then, grep considers the ‘$’ 
sign as a dollar sign, rather than the metacharacter that matches a line end. 

Also, enclose the regular expression in quotes. Single quotes ( ’ ) are safest, but often double 
quotes ( ” ) are sufficient. 


2.6.2. Match Beginning and End of Line with " and $ 

To match a string at the beginning of a line, use the ‘^’ character. For example, to find the 
string ‘fuzz’ at the beginning of a line, type: 
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tutorial% grep *"fUz** playflle 

fuzz 1 

tutorial% 

The ‘ " ’ finds only those lines starting with the word ‘fuzz’. 

To match a string at the end of a line, use ‘ $ For instance, to find ‘fuzz’ at the end of a line, 
type: 

tutor ial% grep playflle 

c 2.997925+8 m/sec fuzz 
au 1.49597871+11 m fuzz 
mole 6.022169+23 fuzz 
e 1.6021917-19 coul fuzz 
tutorial% 

The ‘ $ ’ selects only those lines ending with the word ‘fuzz’. 

Preceding an expression by ‘ " ’ and following it with ‘ $ ’ as in: 

tutorial% grep *"fuzz$’ playflle 
tutorial% 

selects only those lines consisting of ‘fuzz’, and nothing else. This is called an ‘anchored match’ 
because it is anchored at a specific place on a line. Here, grep doesn’t find any string to match. 

If you put the and ‘ $ ’ characters in places other than the beginning of the pattern, or the 
end of the pattern, respectively, they lose their special meanings. 

Find blank lines in a file with the expression This pattern finds lines which have only a new- 
line, and no other text. It doesn’t locate spaces, tabs or other non-printing characters on the 
line. Use it with the —n line number option to specify where those blank lines are: 

tutorial% grep -n ’*$* playflle 
12 : 

14: 

26: 

28: 

t:utorial% 


2.6.3. Matching any Character with \ ’ and ’* 

Use the period (or ‘dot’) metacharacter to match any character at all. So the string ‘ w... ’ 
selects all strings starting with the letter ‘w’, and having three more characters. To find such 
strings at the beginning of a line, use ‘"w... ’. To find such strings at the end of a line, use the 
expression ‘w...$’. Remember that spaces are counted as part of the string. 

As an example, ‘w...’ finds the patterns: 

tut:orial% grep playflle 

water .22491(2.54 kg/m2-SGc2 
wey 40 bu 
weymass 252 lb 
tutorial% 

To find a real period at the end of a sentence, use the ‘ \ ’ escape character to remove any spe¬ 
cial significance. Thus, use the expression ‘w...\.’. The period metacharacter never matches the 
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newline at the end of a line. A consequence of this is that text patterns never match across 
lines; they only match within a line. 

Use the +2*—2 (star) metacharacter the same way you would use the period to match any string. 


2.6.4- Character Classes with [ and ] and — 

To specify a set of characters, enclose them in brackets, ‘[ ]’. This matches any one of the char¬ 
acters inside the brackets. The expression ‘^[abcxyz]’ finds all lines beginning with ‘a’ or ‘b’ or 
‘c’ or ‘x’ or ‘y’ or ‘z’. 

Use the hyphen character ‘ ’ to specify a range of characters inside for example ‘"[a-cx-z]’. 

Here are the common regular expressions: 

Table 2-1: Common Regular Expressions 


Expression 

Translates to 

[a-z] 

all lowercase letters 

|A-Z| 

all uppercase letters 

_ 

all digits 


If you are looking for four-character strings that begin with ‘1’ or ‘L’ and contain only letters, use 
the pattern ‘[Ll][a-z][a-z][a-zJ’, assuming that only the initial letter can be in uppercase. 

In the example ‘"[a-cx-z]’ note that the ‘ " ’ metacharacter (match the beginning of the line) is 
outside the brackets. If it’s inside ‘[ ]’, it inverts the selection process. So the expression ‘ 
["Ll][a-z)[a-z][a-z] ’ specifies all four-letter words that begin with something other than ‘L’ or ‘1’, 
and the pattern ‘"["arz)’ finds all lines except those that begin with lowercase letters. 

It should be emphasized that ranges of characters pertain to the ASCII character set, so that the 
pattern ‘[A-z]’ gets you all upper and lowercase letters and the characters [ ] " _ ‘ . 

This sort of confusion occurs most often when dealing with digits. The pattern ‘[1-30]’ does 
NOT mean ‘numbers in the range one through 30’; it means ‘digits in the range 1 through 3, or 
O’. It is the same as a pattern that looks like ‘[1230]’ or ‘[0-3]’. 

If you really wish to include ‘ ’ in the class of characters, it isn’t necessary to escape it so long 

as it is positioned such that it won’t be confused with a range specification. For example, a 
hyphen at the beginning of the pattern stands for itself: [—ab] means the pattern ‘ — ’ or ‘a’ or 
‘b’. The same is true for the characters ‘[’ and ‘]’. 


2.6.5. Subsets of Regular Expressions 

Here are some possible situations using regular expressions. You can find all but blank lines from 
a file by: 
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tutorial% grep —v *""$* playflie 
/ dimensions 
m *a* 
kg *b* 

< etc. > 

k 1.38047-16 erg/degC 
tutorial% 

The regular expression finds all the blank lines, and the — v saves all the other lines and 
ignores the blank lines. This gets rid of lines that are really blank. 

You can delete the apparently blank lines as well, with: 

tutorial% grep —v *P playfile 

/ dimensions 
m *a* 
kg *b* 

< etc. > 

k 1.38047-16 erg/degC 
tutorial% 

The regular expression says, in effect, ‘look for a beginning of line, followed by any number of 
spaces (including no spaces), followed by an end of line.’ 

If the apparently empty line contains tabs as well as spaces, replace the simple space in the 
above regular expression with an expression that says ‘space or tab’, shown here by the ‘T 
which means type "I. This is the tab character, or TAB key. You used this tab character with 
the tr command to set up the playfile. Your screen shows: 

’"[ ]*$’ 

Also add the —n option to list the line numbers of the blank lines. 

tutorial% grep-n *“[ “1]*$* playffle 
12 : 

14: 

26: 

28: 

tutorial^ 


2.7. Sorting Text Files with ‘sort’ 

To order the contents of a file alphabetically or numerically, use sort. There are many options 
which control the sort order. The most useful are described here. For more details, refer to the 
utility description in the Commandi Reference Manual for the Sun Workstation. 

Sort does not expect fields on a line to appear in a fixed columnar layout. It just works on fields, 
which are normally separated by spaces or tabs (you can specify any field-separator you want). 

This provides a typewriter oriented approach, rather than the historical punched card oriental 
tion. 

Create a file with a random list of classical music composers and their birthdates by typing the 
following: 

cat Franz Haydn 1732 Franz Schubert 1797 Gustav Mahler 1860 Johannes Brahms 1833 W 
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Gustav Mahler 1860 Johannes Brahms 1833 Wolfgang Mozartl756 Sort it as follows: 

tutor!a 1% sort composers 
Franz Haydn 1732 

Franz Schubert 1797 
Gustav Mahler 1860 
Johannes Brcdims 1833 
Wolfgang Mozart 1756 
tutorial% 

Sort orders and displays the list alphabetically by first names. You can tell oort to sort on the 
last name too. Each line in the file is considered to consist of fields, the fields being separated by 
spaces. To get your file in order of last name, tell the program to skip one field, the first names, 
and then start sorting: 

tutorial% sort +1 composers 
Johannes Brahms 1833 
Franz Haydn 1732 

Gustav Mahler 1860 
Wolfgang Mozart 1756 
Franz Schubert 1797 
tutorial% 

This works as long as there are only two fields, and no middle initials, for example. Plan your 
sort accordingly to account for the number of fields. See the Commands Reference Manua/page 
on sort for more details. 

For numerically ordered sorting in this example, skip two fields before starting to sort. Type: 

tutor la 1% sort —b +2 composers 
Franz Haydn 1732 

Wolfgang Mozart 1756 
Franz Schubert 1797 
Johannes Brahms 1833 
Gustav Mahler 1860 
tutorial% 

The —b option tells sort to ignore blanks in all fields on the line. Without this option, each field 
is considered to start immediately after the end of the previous field, so the spaces between the 
last name and the birthdate count as part of the birthdate. Also, sort considers ASCII charac¬ 
ters, and the character for space has a lower value than any of the characters for the digits 0 
through 9. 

To restrict the effect of ignoring blanks to only the numeric field, use the b option in this way: 

tutorial% aort +2b compoaers 
Franz Haydn 1732 

Wolfgang Mozart 1756 
Franz Schubert 1797 
Johannes Brahms 1833 
Gustav Mahler 1860 
tutorial^ 

Here the +2b is called a ‘flag,’ rather than an option, and gives the same results as before. How¬ 
ever, in other situations, you will use one or the other depending on the desired results. 

If you need to sort a file by numbers that do not have the same number of digits, tell sort that 
the charaFranz Schubert 1797 Gustav Mahler 1860 Johannes Brahms 1833 Wolfgang 
Mozartl756cters in the field are to be treated as numbers, and to sort according to the 


Revision A of 15 April 1985 


2-11 



Working with Files 


Beginner's Guide 


arithmetic values of those numbers. Add the letter n (for numeric) after the number of the 
fields skipped before the field that is to be treated in this way: 

tutorial% sort +2n +1 symphonies 

Johannes Brahms 4 

Gustav Mahler 9 

Franz Schubert 9 

Wolfgang Mozart 41 

Franz Haydn 104 

tutorial% 

Using the numeric option implies that spaces are ignored, so you don’t have to use the b option. 
Mahler and Schubert composed the same number of symphonies, and they are listed in alphabet¬ 
ical order by ordering that field (by + 1 ). 

To tell sort to reverse the order of sorting of a field, add the letter r (for reverse) after that field: 

tutorial% sort +2nr +1 symphonies 

Franz Haydn 104 

Wolfgang Mozart 41 

Gustav Mahler 9 

Franz Schubert 9 

Johannes Brahms 4 

tutorial% 

Reversing the sorting order with r is not restricted to numeric sorting, although that’s where 
you’ll usually use it. 

To save the output in a file, use the ~o (for output) option followed by the name of the file that 
is to contain the output. You can give all the filenames to join sorted files. 

And if your input files are already sorted, you can simply merge them by using the —m (for 
merge) option. Refer to the Commands Reference Manual for more details on these options, and 
then experiment with them. 

The —m option saves sort some work by indicating that the files are already sorted, and need 
only be merged. 

You can also get rid of possible duplications of names in files with the —u (for unique) option. 

Normally sort assumes fields are separated by spaces or tabs, but they can be separated by 
something else. Use the —t option to tell sort this. For example: 

tutorial% sort —t: +5 /etc/passwd 
tutorial^ 

sorts the fetcfpasswd file, which uses the colon character ‘:’ as its field separator. 


2.8. Finding Differences Between Files with ‘difP 

When you need to tell what differences there are between one version of a file and another, use 
the diff utility. For example, if you want to find the new ski team members between last year’s 
and this year’s lists, type: 
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tutorial% dlff skiteaniB.82 skiteams.SS 

2c2 

< Shelley Curtis 


> Norman Travers 
7d6 

< Harry Cuthbortson 
10a 10 

> Karen Stevens 
tutorial^ 

This indicates that there are three changes to the file. The second line has changed (‘2c2’), but 
it is still the same line number. The first file (or old version of the line in this case) is preceded 
by a and the second file (the new version in this case) is preceded by a ‘>\ The ‘7d6’ shows 
that line 7 of the original file has been deleted. And ‘lOalO’ indicates the third change, the addi¬ 
tion of a new line after line 10 in the original file. 

Try the diff command on your two files, playfile and start.here: 

tutorial% diff playfile start.here 

The results zip off the screen pretty quickly (we’ll explain how to manipulate that display for 
examination later), but you see that there are lots of differences. Try the diff command on some 
other files and interpret the results. 

There are several options to the diff command that you should read about in the Commands 
Reference Manual. 

o 
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Chapter 3 


Using the Shell 


You have seen how the SheU is the interface between you and the various Sun system com¬ 
mands. Here we describe some more Shell facilities that you should experiment with to do your 
tasks. There is also a description of how to use SunWindows to facilitate working on several jobs 
at once in the window system. 


Redirecting standard input and standard output 

When you run a program on the Sun system, it usually expects some input (data) and produces 
some output (results). This input or standard input is the place from which a program expects to 
read its input, usually your keyboard. The output or standard output is the ‘file’ to which the 
program writes its results, usually your workstation screen. 

You can change these defaults by telling the Shell to take the standard input for a command 
from a file, or to write the standard output of a command to a file. This process is called 
‘redirection’ and uses those ‘>’ and ‘<’ characters you saw in some of the examples in the 
chapter on Working With Files. 

You can also take the standard input of a command directly from the standard output of another 
command, and similarly to direct the standard output of one command straight to the standard 
input of the next command. This feature is called piping, and a string of commands hooked 
together in this way is called a pipeline. 

If a filename argument to a command is prefixed by the ‘>’ character, the standard output of 
that command is redirected to that file instead of going to your workstation screen. For exam¬ 
ple, the Is command displays a list of the directory contents on your workstation screen, but if 
you use ‘> files^ as a redirection indicator, the command line puts the contents listing of the 
current working directory into a file called files, which is placed into the current directory. Try 
this now from your home directory as indicated in the following example:. 

tutorial% cd 
tutorial% Is —1 > fllei 
tutorial% la —I 
total 202 


-rw-i- 1 - 

1 evan 

0 

Aug 

6 

14:03 

files 

-rw-x- 1 - 

1 evan 

959 

Aug 

6 

11:20 

playfile 

-rw-i— 1 — 

1 evan 

959 

Aug 

6 

11:18 

start.here 


tutorial% 

You can also see that your directory now contains three files, playfile, start.kere, and files, which 
contains the long Is listings of all the files. If the named file to which output is redirected doesn’t 
already exist, it is created. 
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You can now view the file at your leisure, or change it around for any useful purposes of your 
own. Look in your new files file with the more command: 

tutorial^ more files 

— 1 ©van 0 Aug 6 11:40 files 

-rw“i - X - 1 evan 959 Aug 6 11:20 playfilo 

- 1 evan 959 Aug 6 11:18 start.hero 

tutorial^ 

You have your current directory listing, including files, which is created before the command 
runs. 

Caution: 

if the file to which you redirect the standard output already exists, the previous contents of 
the file are lost! The C-Shell has a noclobber variable that you can set to prevent this from 
happening. Read about this in the csh description in the Commands Reference Manual. 

If you don’t want to lose the contents of an existing file, but want the output of a command 
appended to the end of it, prefix the filename with two right chevron signs *»’. You used this 
notation before to prepare playfile. As another example, type: 

tutorial% pwd >> files 
tu1:orial% more files 

—r“~ 1 evan O Aug 6 11:40 files 

“rw~r—r-" 1 evan 959 Aug 6 11:20 playfile 

1 ©van 959 Aug 6 11:18 start.hero 

/usr/evan 

tutorial% 

which prints the name of the current working directory at the end of the contents listing of the 
directory. 

In many ways ‘»’ is safer to use than ‘>’ because it doesn’t destroy previous information. 

Just as the ‘>’ character or the *»’ sign redirects the standard output of a command to a file, 
you can redirect the standard input for a command to come from a file, instead of your workstar 
tion keyboard. Prefix the file name with a left chevron sign ‘<’. For example: 

tutorial% midl < gossip 
tutorial^ 

takes mail messages from the file gossip, created previously by an editor. 

You’ll use redirection of output more often than redirection of input because a lot of commands 
are designed to take their input from files anyway. 

If you do not specify any files, commands use the standard input. The cat command, which we 
mentioned briefly in Working with Files as a file viewing command, is one: 
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tutorial% cat 

Type what you want here. 

Cat then displays it on the standard output, 
your workstation screen. 

"D 

Type what you want here. 

Cat then displays it on the standard output, 

your workstation screen, 

tutorial% 

Typing a tells cat that you have finished. 

There are many commands which only act on the standard input, that is, what you type at your 
keyboard. If you want these to work on a file instead, you have to redirect the input to be from 
that file; for instance: 

tutorial% cat < files 

-rw-i— 1 — 1 evan 

-rw-i- 1 - 1 evan 

-rw-j- 1 - 1 evan 

/usr/evan 
tutorial% 

concatenates the contents of the file called files to the standard output. 

Also consider the tr (translate) command, which you can also redirect to operate on a file as 
input instead of the standard input: 

tutorial% tr a-s A-Z < files > FILES 
tutorial% more FILES 

-RW-R--R-- 1 EVAN O AUG 6 11:40 FILES 

-RW~R--R-- 1 EVAN 959 AUG 6 11:20 PLAYFILE 

-RW-R--R-- 1 EVAN 959 AUG 6 11:18 START.HERE 

/USR/EVAN 
tutorial% 

As you saw above, the cat command can use the standard input or, with redirection, a file as 
input. What cat really does best is indeed what it says, it ‘concatenates’ or joins files with the 
appropriate redirection. For example, to join two files, files and playfile, to form a third file 
mess that contains both, type; 

tutorial% cat files playfile > mess 
tutorial% more mess 

-rw-i- 1 - 1 evan 0 Aug 

-rw-r--r-- 1 evan 959 Aug 

-rw-r--i- 1 evan 959 Aug 

/usr/evan 
/ dimensions 
m *a* 

< etc. > 

Xunit 1,00202-13m 
k 1,38047-16 erg/degC 
tutorial% 

You then have the mess file that contains files followed by playfile. 


6 11:40 files 
6 11:20 playfile 
6 11:18 start,hero 


O Aug 6 11:40 files 
959 Aug 6 11:20 playfile 
959 Aug 6 11:18 start,hero 
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To add one file to the end of another, use cat and the double chevron redirection symbol 
If you want to add the contents of playjile to the end of type: 

tutor ial% cat playflle » flies 
tutorial% more filet 


-rw-i-»- 

1 

evan 

0 Aug 

6 

11:40 files 

-rw-i- 1 - 

1 

evan 

959 Aug 

6 

11:20 playfile 

-rw-i- 1 - 

/usr/evan 
< etc. > 

1 

evan 

959 Aug 

6 

11:18 start.hero 


Xunit 1.00202-13m 
k 1.38047-16 erg/degC 
tutorial% 

You then have two files, the original playjile file and a new files file that contains files followed 
by playjile. 

Caution: 

Be careful that you do not use the same filename when redirecting both standard input and 
Standard Output. The first thing that happens when you use ‘>’ is that the file it points to 
is created. If that file already exists and if there’s something in it, the contents are lost. For 
example: 

tutorial% cat < now > then 
tutorial% 

works, but in the following cases, the files are clobbered: 

tutor ial% cat < thisdata > thisdata 
cat: input — is output 
tutorial% 

or 

tutorial% cat thlsdata > thisdata 
cat: input thisdata is output 
tutorial^ 

The caf command warns you with ‘cat: input — is output’ that something is wrong, but con¬ 
tinues to overwrite or clobber your file anyway. Another such problem occurs if you try: 

tutorial% cat a b > B 
tutorial% 

which clobbers b before running cat. See the csk ‘noclobber’ option to prevent this. 


3.2. Connecting Processes with Pipes 

You can run the standard output of one process (or program) as the standard input of another 
process when you form a ‘pipeline.’ 

Using the wc and who commands, and the ‘j’ (vertical bar) ‘pipe’ symbol, find out how many peo¬ 
ple are logged in: 

tutorial% who | wc -I 
1 

tutorial% 
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Here who feeds its standard output to the standard input of the wc command, which counts lines 
with the —I option. And yes, that number 1 is you, if you are the only one on your system. 

A pipeline is a flow of data that several programs (or processes) operate on in turn. If you write 
the sequence: 

tutorial% la —1 /usr | grep evan j aort +3iir | Ipr 
tutorial% 

you have a string of connected commands or a ‘pipeline.’ The standard output of the command 
to the left of the ‘[’ becomes the standard input to the command on the right of ‘j’. 

Here the long Is listing of files and subdirectories in /usr is passed to the grep command instead 
of to the default standard output, the workstation screen. Grep selects all lines containing the 
string ‘evan’ from its standard input, and sort sorts the fourth field of all those selected lines in 
reverse numerical order. 

Lpr routes its input to a printer, so you get a print-out instead of seeing the results on the 
screen. This, in fact, is the most common use of piping. Since all commands except lpr provide 
output to the standard output, the only way to get a hard copy print-out of a file at the end of 
such a pipe sequence is to pipe it to lpr. 

You can type all the commands in the pipeline one at a time, but here the system does all the 
intermediate work for you, and it’s much quicker because you don’t have to wait for each com¬ 
mand to finish. 

Some commands are special. Ls does not accept the standard input because its ‘input’ is a direc¬ 
tory whose contents are to be listed. You can only use Is as the first command in a pipeline. 
The lpr command does not write to the standard output, instead its ‘output’ is to a printer some¬ 
where. You can only use lpr as the last command in a pipeline. 

You can use both redirection of input and output with pipelines. 


3.3. Controlling Jobs 

Because the Sun operating system is a multi-tasking system, you can run more than one job or 
‘process’ at a time. You can manipulate your jobs by running them in either the foreground or 
the background, stopping, suspending, or killing them as we describe below. 


S,S.L Foreground and Background Processes 

You saw what processes are running with the ps (process status) command. Everytime you ask 
the Shell to run a command, it runs that command as a separate process. The processes which 
converse with your workstation are called ‘foreground’ processes because they are in the fore¬ 
ground of your attention. Normally, each command you type, or each pipeline of commands, 
runs as foreground processes, and they run at your workstation ‘while you wait.’ Each window on 
your screen represents at least one foreground process. 

This couid mean a lot of waiting for processes to finish, so you can also run commands in the 
‘background.’ Your system prompt re-appears immediately after you type the command, and you 
can continue with another task while it completes. This is particularly useful for commands that 
take a long time to run. 
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3.3.1.1, Running Jobs in the Background with 

To run a command in the background, type an ampersand at the end of the command and 
its arguments: 

tutorial% sort files & 

[1] 2042 
tutorial% 

The ‘[1]’ is the job number and the ‘2042’ number reply is the PID (or process identity number 
you saw earlier with the ps command) that the operating system associates with the command 
you typed. Sometimes the process you put in the background calls up other processes which you 
don’t know about, but only the number for the primary (or parent) process is shown when you 
type the command. In this example, sort displays the sorted files files on your screen. 

You can then type another command to have the Sun system doing several things for you at the 
same time. Or you can log off, and the background command continues running. 

Avoid having too many things going on at the same time; your system has to play ringmaster in 
your multi-ringed circus, so it might end up taking just as long to complete all your tasks as if 
you had done them one by one at the keyboard waiting for the prompt each time in the fore¬ 
ground. 

Caution: 

if your background process is taking input from a file, don’t start another command, either 
in the background or in the foreground, which will modify the contents of that file. Results 
can be unpredictable. 

To ensure that your output goes to the right place and is not mixed up with other files or lost, 
redirect the output of the background command to a file: 

tutorial% sort files > flles.sorted & 

[1] 2043 
tutorial% 

Now the output of your background command will not disturb you when you execute commands 
in the foreground. And you can view it at your leisure with more: 

tutorial% more flles.sorted 


-rw-i— 1 — 1 

evan 

959 Aug 

6 11:18 start.here 

-rw-i—I— 1 

/ constants 

evan 

959 Aug 

6 11:20 playfilo 

< etc. > 




wey 40 bu 

weymass 252 

tutorial% 

lb 




Or you can pipe the results to the printer: 

tutorial% sort files {Ipr & 

[1] 1043 1044 
tutorial% 
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3.3.2. Stopping and Resuming Jobs 

If you start a foreground job, you can stop it temporarily with a "Z and resume it later: 

tutor la 1% spell playfile > mlspell 
"Z 

Stopped 

tutorial% 

If you put a job in the background, you can stop it with a stop command: 

tutor la 1% sort playfile Sk 
[2] 2345 

tutorial% stop %t 

[2]+ Stopped (signal) sort playfile 

You need to type the job number prefixed by the after the stop command to indicate which 
job to suspend if you’re running more than one. You can resume a stopped job later as you’ll 
learn in Bringing Jobs to the ForeGround. 


3.3.3. Placing Jobs in the Background 

If you start a job in the foreground, and then decide you want to work on something else while it 
is completing, use the following sequence: 

tutorial% spell playfile > mlspell 
"Z 

Stopped 
tutorial% bg 

[1] spell playfile > mispell & 
tutorial% 

Here you start running the spell utility, which finds those ubiquitous spelling errors, then you 
decide to work on something else, and stop it with "Z. Typing bg then puts that job in the 
background for completion. 


3.3.4^ Bringing Jobs to the Foreground 

If you put a job in the background, and then decide you need it back in the foreground, use the 
following sequence: 
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tutorial% spell playfile > mlspell & 

[1] 321 

tutorial% la —F > mydlr & 

[2] 322 

tutorial% who ] wc 
"Z 

Stopped 

[3] 323 324 
tutorial% jobs 

[1] - Running 

[2] Running 

[3] + Stopped 
tutorial% fg %Z 
Is -F > mydir 
tutorial% more mydlr 

Typing the johi command displays a job table to remind you which job is which. It also gives 
you the status: for the current job and for the previous job. 

The fg ‘foreground’ command brings the background job Is —F to the foreground. Note that to 
bring a particular command to the foreground, you precede the job number with the sign. 
Note that you can also type the command you want to bring to the foreground; that is, in this 
example ‘%ls’ would mean the same thing as ^%2\ You only need to type a unique part of the 
full command, hence the Is, and not the whole sequence. 

You can also use fg to restart a job previously suspended with ‘^Z’, 


spell playfilo > mispell 
Is —F > mydir 
who I wc 


3,3.5. Killing Jobs and Processes with ‘kilP 

If you start a command running in the background, and then change your mind for some reason, 
you can stop the process with the kill command and the PID. Don’t forget that you can also 
interrupt a running command with ^C. 

From the other example, we got a procces ID of321. To kill it you type: 

tutorial% spell playflle > mlspell & 

[1] 321 

tutorial% kill 331 

[1] Killed spell playfile > mispell 

tutorial% 

You can also type kill %1 to kill the process running as job number 1. 

A process can use several subprocesses called children. To kill them one by one may take some 
time. To stop them all, find the subprocess’ PIDs with the ps command and stop them all with 
the same kill. Some processes are clever enough to ignore the stop signal number that the sys¬ 
tem sends them. If this is the case, but you really want to kill a certain command, type; 

tutorial% kill -9 321 

[2] Killed spell playfile > mispell 

tutorial% 

The signal number 9 is a sure kill signal option. You can also use kill 0, to kill everything that’s 
either running in the background or stopped. 
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3.4. Recalling Previous Commands with ‘history’ 

The C-Shell has a built-in history mechanism to keep track of some number of the commands 
you type. This is handy for re-executing long commands and for changing parts of and re- 
executing previously typed commands, 

You determine the number of commands by setting a variable called ‘history’ in your .cshrc file 
with an editor: 

set history=30 

After reading the chapter on the editor, come back to this part and create a .cshrc file with the 
history option. A typical display from the history buffer is: 

tutor!a 1% history 

1 Is -1 

2 cd /intro/lessons 

3 history 
tutorial% 

Here you clearly have not been logged on very long because you’ve only typed three commands. 
Note that the history command also appears as the last command. 

If the ‘history’ variable is set to 30, the history command displays the last 30 commands you 
typed during the current login session. 

The first thing to look at is correcting the previous command. If you mistype something, such as 
changing directories, and get the ‘No such file or directory’ message, you don’t need to retype 
the whole cd command and pathname. Simply use the ‘"’ character to bracket the incorrect and 
correct spellings and make the substition as follows: 

tutorial% cd /usr/evan/intro/lesons 

/usr/evan/intro/lesons: No such file or directory 
tutorial% 

To correct this ‘lesons’ typo, type: 

tutorial% ''lesons^lessons^ 
cd /usr/evan/intro/lessons 
tutorial% 

or even just: 

tutorial% ‘‘8o‘‘88o'‘ 
cd /usr/evan/intro/lessons 
tutorial% 

History echoes the command it is executing. 

The characters act as delimiters to surround the two strings. The first string is the 
want changed. The second string is the thing you want to change it to. The corrected 
is echoed back at you. 

Use the history facility to see what happened to the commands: 


thing you 
command 
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tutorial% history 

1 Is -1 

2 cd intro/lessons 

3 history 

4 cd /usr/evan/intro/lesons 

5 cd /usr/evan/intro/lessons 

6 history 
tutorial% 

The two cd commands from the examples above, the erroneous one and the corrected one, now 
appear in the history buffer. 

To run the previous command again, simply type: 

tutorial% !! 
history 

1 Is -1 

2 cd intro/lessons 

3 history 

4 cd /usr/evan/intro/lesons 

5 cd /usr/evan/intro/lessons 

6 history 

7 history 
tutorial% 

To avoid typing out a long command line that you have run previously, type an exclamation 
mark in front of a unique number of characters from the previous command. For example, 
assume you want to re-run the cd command noted before. Use the ‘!’ character and cd to ask 
the Shell to search backwards through the history file for a command beginning with the letters 
‘cd\ 

tutorial% !cd 

cd /usr/evan/intro/lessons 
tutorial% 

You don’t have to to type the whole command name, just enough of the previous command to 
make it unique. So you can also type the cd command like this: 

tutorial% !c 

cd /usr/evan/intro/lessons 
tutorial% 

and it will do just as well. 

If you ask for a command that the Shell cannot find, an error message is displayed: 

tutorial% !xd 

xd: Event not found. 

tutorial^ 

You can also refer directly to a previous command in the history file, by typing the exclamation 
mark followed by the number of the command in the history buffer. For example, you can re¬ 
run command number 1 in the buffer like this: 
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tutorial% !1 
Is -1 

< output from the Is command > 
tutorial% 

The number must immediately follow the exclamation mark. 

Another version of ‘repeat a previous command’ is to use the dollar sign to refer to the last 
argument of the previous command: 

tutor ial% mv /usr/evan/Intro/leasons/noteg extra 
tutorial% pr !$| Ipr 
pr extra ) Ipr 
tutorial% 

As well as simply repeating a previous command, you can make changes to the command at the 
same time. Consider the history buffer after the last few changes: 

tutor!a 1% history 

1 Is -1 

2 cd intro/lessons 

3 history 

4 cd /usr/evan/intro/lesons 

5 cd /usr/ovan/intro/lessons 

6 history 

7 history 

8 cd /usr/evan/intro/lGssons 

9 cd /usr/evan/intro/lessons 

10 Is -1 

11 mv /usr/evan/intro/lessons/notes extra 

12 pr extra | Ipr 

13 history 
tutorial% 

You can see the substitutions that were made in previous commands. 

Assume that the file you want to move from Evan’s directory was actually the data file, not the 
notes file. To avoid all the tiresome typing of the whole pathname again, use the Shell substitu¬ 
tion capability; 

tutorial% !ll:B/noteB/data 

mv /usr/evan/intro/lessons/data extra 

tutorial% 


3.5. Substituting with ^alias’ 

The Shell also provides a method of making shorthand names or aliases for frequently used but 
long-winded commands. 

Assume that you are updating a series of plans for a large software project. Each plan and its 
related meeting minutes are in a separate directory named jmiscjmasterlyroiectjdocuments. 
The last element in the pathname is plana for project plan A, planb for project plan B, and so 
on. Instead of typing these long pathnames every time your group makes changes in a plan, 
define an alias in your .cskrc file in your home directory: 
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alias plana cd /misc/master/project/dociments/plana 
alias planb cd /misc/master/project/docxments/planb 
alias plane cd /roisc/master/project/documents/planc 
alias pland cd /misc/master/project/documonts/pland 
alias plane cd /misc/master/project/docnments/plane 

Now you have some new commands, so all you have to do to change directory to one is type; 

tutor!a1% planb 
tutorial% pwd 

/misc/master/project/documents/p1anb 
tutorial% 

You don’t even have to define five separate alias lines; one suffices if you use ‘\!$’: 

alias plan cd /misc/master/project/documents/plan\!$ 

The ‘\!$’ notation refers to the last argument typed on the command line. The ‘ \ ’ (escape) 
character prevents the ‘!$’ from being expanded until a plan command is actually typed. Now 
you can change to the plane directory like this: 

tutoria1% plane 
tutorial% pwd 

/misc/master/project/documents/plane 
tutorial^ 

The C-Shell constructs plane out of the argument you typed, c, and the plan that was defined in 
the alias. 


3.6. Using SunWindows 

To use SunWindows, you must have /nsr/ bin in your path in your .login file in your home direc¬ 
tory, Your .login file might look something like: 

setenv EXINIT 'set noai wrapmargin=8' 

set path=(. / /bin /usr/bin /usr/local /usr/local/bin /usr/ucb /etc /usr/hosts) 
set mail=(10 /usr/spool/mail/$USER) 

To create the appropriate devices, set your userid to root, change directory to /dev, and run the 
Shell script MAK.LEV on winO and mouse. That sequence is: 

tutorlal% su 

Password: 

tutorial# cd /dev 

tutorial# MAK.LEV wlnO 

tutorial# MAK.LEV mouse 

tutorial# *D 

tutorial% 

You are then ready to use SunWindows. To start, type: 

tut or la 1% suntools 

Your workstation screen turns grey and the arrow cursor that tracks the mouse motions appears 
in the upper lefthand corner. You always have one window open called the Root Window, which 
contains the grey pattern you see on the screen now. This grey is the background for the 
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suntooh environment. 

You may have to circle the mouse on the pad several times in large, slow circles to orient it 
properly or to make the cursor to appear. The long side of the mouse should be parallel to the 
short side of the mousepad. 

To display a window, press the right or menu button on the mouse. You see the Root Manager 
menu similar to: 

Root Mgr _ 

New Shell 
New Graphics 

Exit _ 

Redisplay All 


Move the cursor to the New Shell box and release the button. You’ll note that the item you 
select shows in reverse video. 

We use the word cunor here to mean the arrow that tracks the mouse movements. In general, 
pressing the button displays a menu. Move the cursor over a menu item then release the button 
to put the specified item into action. When we say Press, we mean press the button and hold it 
down until you have positioned the arrow cursor at the desired place. Sometimes all you need to 
do is click the button, that is, press and release it immediately. We will make the distinction 
when necessary because the effects are different. 

A window appears on your screen: 



Figure 3-1: Sample Window 

You can now use the window for whatever purpose you need, executing Shell commands or edit¬ 
ing a file for example. 
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You’ll note that you have to keep the cursor in the window area to do work. If you move it to 
the grey area and try to type a command to the shell, for instance, nothing happens. 


3.6.1, Working with Windows — the Tool Manager 

There are several functions you can perform that facilitate your work, such as moving windows 
from one place to another, closing one down into its icon image, or uncovering an overlapped 
window. For these you’ll use the Tool Manager menu. Move the cursor onto the window’s 
namestripe or one of the window’s borders. Now press the right mouse button, and select what 
you want to do on the Tool Manager menu: 

Tool Mgr 

Close _ 

Move 

Stretch 

Expose 

Hide 

RePisplay 
Quit _ 


To shrink a window tool to a small icon in the corner of the workstation screen, you use the 
Close function. The processes continue to run even though the window is closed. 

To move or stretch a window, position the cursor in the name stripe (the black border at the top 
of the window) or on an outer window boundary, and invoke the Move or Stretch function. In 
these cases, additional action is required. You are prompted on the screen with: 

Press the left or middle button near the side or corner you 
wish to drag and hold the button down while dragging the 
bounding box to the location you want; then release the 
button. To cancel, press the right button now. _ 


To bring to the front of the window stack or expose the overlapped windows, use the Expose 
item. This brings the specified window to the front. Hide puts a window on the bottom of the 
stack. 

ReDispIay repaints a window in case something was written over it. If several of the windows 
are been written over, use the Root Manager menu ReDisplay All to redraw all the windows 
you have open. 

To reopen a closed window, position the cursor over the icon shell and use the Open function. 

There are faster ways to do several of the above maneuvers. We describe them in Quick Tool 
Manager Functions. 

Use Quit to terminate a window. 
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You can change your mind, as the screen shows: 

Press the left mouse button 
to confirm Quit. To cancel, 
press the right mouse button 
now. 


To get another window, simply position the arrow cursor on the grey area and press the right 
button again to call up the Root Manager menu to create a new Shell. The new window will 
overlap the first as shown: 
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Figure 3-2: Overlapping Windows 

You can start something in one window, then move the mouse to another window, and type or 
use the mouse again without waiting for whatever you started in the first window to complete. 
You can also of course expose, hide, move windows, and so on to make the arrangement 
appropriate to whatever you are working on. In this figure we are editing a text file with one 
shelltool and listing a directory contents with the other. Both have been moved from their 
default positions to show more of the text. 

You will usually use the mouse buttons like this: 

• left — selecting objects 

• middle — adjusting selections to more or fewer objects 

• right — invoking menus 

If you change your mind after calling up a menu and indicating a function, simply move the 
arrow cursor off the menu and release the mouse button to cancel the command. 

o 
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3.6.2, Copying Text 

When you want to copy some text from one place to another in the same window or from one 
window to another, position the cursor at the start of the text you want to copy and click the 
left button. A small box marks the spot. The text within the box displays in reverse video. 

Reposition the cursor at the end of the text and click the middle button to expand the box 
around the body of text you want to copy. 

Now position the arrow cursor in the window where you want the text to appear at the spot 
marked by the regular cursor. Press the right button, indicate Stuff with the arrow cursor and 
release the button. 

Selection 

Stuff 

The text is copied to the new position: 



Figure 3-3: Copying Text 


Here we have copied a cd command to avoid having to retype the long directory name. You can 
of course also copy blocks of text within an editor. 

Note: You must be in insert mode to copy text if you are editing a file with the vi editor. 
Beware that if you copy a shell command that includes a carriage return, your new line will be 
executed immediately as it will contain that carriage return too. 

Practice copying text a few times to learn the button sequence. 
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S.6,3. Quick Tool Manager Functions 

You can quickly invoke several of the tool manager functions without having to bring up a menu 
by simply pressing one of the mouse buttons with the mouse cursor in the appropriate spot. 
These accelerators are described in the following table: 

Table 3-1: Quick Tool Manager Functions 


Function 

How to Do It 

Open an icon 

Click the left button with the cursor over the icon 

Move a window or an icon 

Press the middle button with the cursor in the tool 
window’s name stripe or outer boundary 

Expose a window 

Click the left mouse button with the cursor in the 
name stripe of the window you want to expose 

Help 

Type a question mark with the cursor in the name 
stripe of any window to display a message describ¬ 
ing possible actions 

Insert text 

Hold down the SHIFT key on your keyboard while 
clicking the right mouse button to insert text. 


If nothing happens, recheck the cursor position to be sure it is in an appropriate place — on a 
name stripe, border, or icon. 


3.6.Simple Graphics Demos 

Now try some sample graphics. Call up the New Graphics tool window through the Root 
Manager. 

Try the bouncing ball demo bouncedemo: 

tutorial% cd /usr/demo 
tutorial% bouncedemo 

Use *C to stop the demo. 

Also sample the simulated cruise through the galaxy jumpdemo: 

tutorial% cd /uBr/demo 
tutorial^ Jumpdemo 

For information on more graphics tools, refer to the Commands Reference Manual on suntools. 
3.6.5. Quitting SunWindows 

To leave SunWindows, use the Root Manager to Exit. This closes all windows and terminates 
the associated processes. 
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Caution: 

Be sure you complete everything before you start exiting SunWlndows, especially any files 
you are editing. All processes left running are terminated without warning. 


S,6.6. Customizing SunWindows — the .suntools File 

If you want several application programs or tools to start up automatically when you type sun- 
tools, put a .suntools file in your home directory. The .suntools file works a lot like the .login 
file; it starts several processes in motion as soon as you type suntools. 

If you want a .suntools file now, you can either learn how to create and edit a file to make your 
own by reading ahead to Creating and Editing Text Files — the ^vi' Editor or by reading ahead 
to Copying Files from Other Systems with VcpMn Communcations. This latter section provides 
details on how to copy a file from someone else’s machine to your home directory. The latter is 
perhaps the easier of the two methods. In either case, exit SunWindows then reenter SunWin¬ 
dows for the new .suntools file to go into effect. The command sequence for copying someone 
else’s file is: 

tutorial% cd 

tutorial% rep angeh/usr/henry/.suntools * 
tutorial% 

Here is a sample .suntools file for a Model 100/150 you may want to copy: 


clocktool 

680 

10 

334 

60 

960 

0 

64 

64 

1 

shelltooi 

10 

0 

732 

792 

960 

672 

64 

64 

0 

shelltooi 

600 

80 

334 

410 

960 

736 

64 

64 

1 ~C 


This automatically makes an open shelltooi window, and puts a working clock and a console win¬ 
dow represented as icons on your screen. 
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Figure 3-4: Sample .suntools Set Up 
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The first set of numbers represents the location and size of the open windows, and the second set 
of numbers represents the location and size of the closed windows’ icons. Here we automatically 
call up one open window, a clock icon in the upper righthand corner of the screen, and a CON¬ 
SOLE shell icon in the lower righthand corner. In each set, the numbers represent the 2 coordi¬ 
nate, the y coordinate, the length, and the height respectively. The last single number indicates 
that the tools will either be “open” as in the case of the shelltool window or “closed” as in the 
cases of the clocktool and CONSOLE shelltool, which are represented as icons. 

For the Model 120 with a Sun—2 video board, a sample .suntooU file looks like: 


/usr/bin/clocktool 
/usr/bin/shelltool 
/usr/bin/sh©lltool 
/usr/bin/shelItool 


794 676 200 61 
0 333 650 567 
0 O 650 567 
504 71 647 829 


1084 4 64 64 1 

1014 12 64 64 O -C 

944 12 64 64 O 

874 12 64 64 O 


See the .snntools description in the Commandi Reference Manual for detaiU on what else you 
can do in your ^suntooh file. 
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Chapter 4 


Creating and Editing Text Files — the vi Editor 


The Sun system supports several editors, vi (pronounced ‘vee-eye’) ex (pronounced ‘ee-ex’), erf, 
and sed. This chapter provides the basics for learning to use the ‘display’ or ‘screen’ editor vi, 
which is a screen-oriented version of ex. Many of the more useful operations that can be per¬ 
formed in vi call upon ex functions, so in learning vi, you’re also gaining an understanding of ex. 
In addition, ex is based on the erf editor, but has many extensions and additional features. Here 
you learn about the top of the line, and a little bit about the others too. Refer to the Editing 
and Text Processing on the Sun Workstation for more details. 

Vi displays a portion of your file on your workstation screen. You can move the cursor around 
on the screen to make changes by adding, deleting, or replacing text, and you can move the 
screen itself around to edit different parts of the file. 

Almost every key on the keyboard is a vi command. There are also combinations of the SHIFT 
key and the other keys, and combinations of the CTRL key and other keys. Note that when we 
say ‘A,’ we mean uppercase ‘A’. Lowercase ‘a’ means something different. 


4»1. Command and Insert Modes 

There are two modes in vi, command mode and insert mode. In command mode, you can move 
the cursor around the screen, scroll the screen, search for patterns, save the file, and do other 
operations which don’t involve entering fresh text. To enter new text into the file you must be 
in insert mode, which you can get with the a, A, i, I, O, o , and C commands. You get out of 
insert mode by typing the ESC (ESCAPE) key (or ALT on some keyboards). The significant 
characteristic of insert mode is that commands can’t be used, so anything you type (except ESC) 
is inserted into the file. If you change your mind anytime using vi, pressing ESC cancels the com¬ 
mand you started and reverses to command mode. Also if you are unsure of which mode you are 
in, press ESC until the screen flashes or the bell rings; this means that you are back in command 
mode. 

Start working on your playfile. To use the vi editor, type: 

tutor ial% vl playfile 

The screen displays something like: 

/ dimensions 
m *a* 
kg *b* 

< etc. > 
spat 4 pi sr 

“playfile** 60 lines, 959 characters 
with the cursor at the upper lefthand corner. 
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Use playfile in the next section to practice moving the cursor, scrolling the screen, and so on. 


4.2. Moving the Cursor 

There are several ways of changing the position of the cursor. You can move it character by 
character, word by word, sentence by sentence, forward, backward, from one screen to another, 
and on and on. We present the more useful ways here, but you’ll want to read further on vi to 
learn all the facilities. 


4 . 2 . 1 . /, h, k, j ~~ Forward, Backward, Up, and Down 

To position the cursor a character at a time, use the four keys h, j, k, I, which move the cursor 
as follows: 

h move the cursor one character to the left 

1 move the cursor one character to the right 

k move the cursor up one line 
j move the cursor down one line 

After a little practice, you’ll find these easy to use because they’re right under your finger^ 

The BACKSPACE key on your workstation keyboard has the same function as "H; you can use 
it to move the cursor to the left. Typing ‘h’ without holding the control key works too. Both " J 
and "N move the cursor down to the next line. The LINEFEED key has the same function as 
" J. Test out all these possibilities on your workstation or terminal. 

You can move the cursor several lines or characters by pressing the key repeatedly, or you can 
hold down the key as you go for an automatic repeat. (Some terminals have a key marked 
REPEAT. If you hold this key down while typing some other character, that character is 
repeated until you let go.) Use these features when you have long distances to move the cursor. 

You can give the cursor positioning commands a preceding count to move the cursor a specified 
number of characters or lines. For instance, ‘81’ moves the cursor eight characters to the right. 

If the cursor is towards the end of a line, and you move it down to a shorter line, then the cursor 
is placed at the end of that shorter line. However it reverts to its original horizontal position on 
any line that is long enough. 

Moving the cursor down one line past the last line of the screen scrolls the screen up one line. 
You cannot go past the end of the file, there is no wrap around to the beginning. Moving the 
cursor up one line from the top line of the screen scrolls the screen down one line. 

Some of the vi commands use the bottom line of the screen, to display the command or its result. 
The bottom line initially shows the filename and length. 


4 . 2 . 2 . ^ 0 and $ — Move to Beginning or End of Line 

For horizontal motions along the lines, three useful functions are: 

move cursor to first non-blank character of line 
0 move cursor to the real beginning of line 

$ move cursor to end of line 
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4 . 2 .S. Hf M, L — Move to Home^ Middle, and Last Line on Screen 

Three more basic cursor movements are: 

H home 
M middle 
L last 

The H command homes the cursor onto the top line of the screen, M moves the cursor to the 
middle line of the screen, and L moves it to the last line of the screen. H and L take preceding 
counts, for example, 3H moves to the 3rd line on the screen, 2L moves to the second line from 
the bottom. If you have a key marked HOME on your terminal, this usually achieves the same 
as the H command. 


4 . 2 . 4 ^ w, b, e —Moving by Words 

To move over the text a word at a time instead of only character-by-character, use the com¬ 
mands: 

w move forward to beginning of next word 
e move to end of this word 
b move back to beginning of word 

If you are already at the beginning of a word when you type a ‘b’, the cursor goes to the begin¬ 
ning of the previous word. If you are at the end of a word when you type an ‘e’, the cursor 
moves to the end of the next word. 

A ‘word’ is anything consisting of letters, digits and underscores, surrounded by anything which 
is not a letter, a digit or an underscore. This definition covers identifiers in most programming 
languages, so the commands are useful for editing both programs and documentation. 

If your file is shorter than the screen, on-screen lines not present in the file are indicated by the 
tilde character (") to avoid confusion with blank lines in the file. 

All the commands ‘w’, ‘b’, and ‘e’, move past the end of a line. If you use them to move past the 
upper or lower limits of the screen, the lines scroll up the screen accordingly. 

You can use a preceding count with these commands, so ‘5w’ moves the cursor forward five 
words, for example. 


4^2.5. (, ),{,}— Moving by Sentences and Paragraphs 

The ‘(’ and ‘)’ commands move the cursor over sentences, ‘)’ to the beginning of the next sen¬ 
tence, and to the beginning of the previous sentence. These commands take counts too, so ‘2)’ 
moves forward 2 sentences; ‘3(’ moves back three sentences. A sentence is defined as string of 
words ending with one of the characters or followed by two spaces, or occurring at the 

end of a line. 

The ‘}’ (beginning of next paragraph) and (beginning of previous paragraph) commands work 
similarly to the ‘(’ and ‘)’ commands except they Jump the cursor by paragraphs instead of sen¬ 
tences. However, if your file is text to be input to the nroffiext formatter using the macro pack¬ 
ages —ms or —mm, vi recognizes the ‘start of paragraph’ macros available in these packages, and 
positions the cursor accordingly. 
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If the file you are editing contains text to be formatted using one of the nroff macro packages 
described in Printing and Formatting Documents, you can also tell vi to move forward or back¬ 
ward whole sections by using ‘]j’ to move forward a section, and ‘[[’ to move back a section. 

If the text you are editing is C programming language source text, ‘[|’ and ‘jj’ move forward or 
backward over whole procedures. 


4.3. Scrolling the Screen 

Try the following commands to scroll the screen: 

““D scroll down half screen 
scroll up half screen 
"F scroll down a full screen 
"B scroll up a full screen 

With '"F and ''B, two lines from the ‘old’ screen are retained in the ‘new’ screen for continuity. 
These are the same commands you use to scroll the screen with view. 


4.S.I. Moving to Specific Lines in the File 

When editing, you may wish to position the cursor at some specific line. The command you use 
to do this is ‘G’ or ‘go to’ command. For example, to move to the beginning, type ‘1(S’. To 
move to line 45, type ‘45G’. Typing the G command with no preceding line number moves the 
cursor to the last line of the file. 

To find a particular character string an 3 rwhere in the file, you use the standard ‘/’ command. It 
is echoed at the bottom line of the screen where you then type the string you want to search for, 
either as a fixed character string, or as a regular expression. Vi uses the same regular expres¬ 
sions you learned about with grep. To signal the end of the character string, type either ESC, or 
RETURN. 

Vi places the cursor at the start of the next string that matches what you typed, going forward 
through the file. 

If the string is not in the current screen, the screen is changed to display that part of the file 

which contains the string. Try this now with a string that is not on the screen, and notice how 

the screen moves to track it. 

Searches wrap around the file, so if the string isn’t found between the current position and the 
end of the file, it wraps around and continues from the beginning of the file. If the string is not 
found, ‘Pattern not Found’ is displayed on the bottom line of the screen. 

Use the ‘?’ command plus a string to search backward through the file instead of forward. 
Again, what you type is echoed on the bottom line of the screen. 

To repeat a forward search, type ‘//’. To repeat a backward search, use Or use two other 
commands: 

n to find next occurrence of same string in same direction 

N to find next occurrence of same string in reverse direction 
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4.4. Inserting New Text 

The two basic commands to enter new text into a file are a, which appends text after the 
current cursor position, and i which inserts text before the current cursor position. When you 
give either of these commands, any following text you type gets put in the file. To stop text 
entry, press the ESC key. 

If you are using a dumb terminal, when you type in the additional text, it might look as if you 
are over-typing the existing text. Typing ESC straightens it out. 

If you make a mistake while entering new text, correct it in the usual way with the .LEL, BACK¬ 
SPACE or "H keys. 

You can also use s for ‘substitute’ to enter new text; it replaces a single character with lots of 
characters, until you type ESC. 

There are two other simple commands for entering additional text: 

I insert text at the beginning of the line 
A append text at the end of the line 

Regardless of where the cursor is positioned on a line, the I command inserts text at the begin¬ 
ning of that line; 

Similarly, A adds text at the end of the line, regardless of the cursor position. Blank lines of 
text can be inserted by using the A command and making the first character you enter a 
RETURN. 

Two other commands that can be used to add new lines of text are the ‘open lines’ comminds, o 
and O. The o command opens up a blank line following the current line, and the cursor is 
placed at the beginning of the new line. Anything you type from now on, until you type ESC, 
becomes the new line or lines. To get just a blank line, type ESC immediately following the o. 

The O command works like the o command, except that it opens a line above the current one, 
instead of below. This is the easiest way to add lines before the beginning of a file. 

The uppercase R command replaces (overtypes) characters until you tell it to stop by pressing 
the ESC key. The R command is useful when you have a fixed format, for example, where you 
want to preserve column alignment. 

Lowercase r ‘replaces’ a single character. For example, if you misspelled ‘character’ as ‘cherac- 
ter,’ place the cursor on the ‘e’ typo, type the r, then type the correct ‘a’. The ‘r’ command does 
not require typing ESC, since you are replacing only one character. 


4.5. Creating a New File 

To create a new file, simply call up vi with the name of the file you want to create: 
tutorial% vl stuff 

The screen goes almost completely blank: 
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The cursor is in the top left hand corner with a row of tildes down the left hand edge of the 
screen. The ‘"'’s indicate that there are no lines in the file corresponding to these lines on the 
display. The bottom line displays the name of the file you are creating, and an indication that it 
is a new file. 

Type a or i and type in all the text you want. 

When you have finished and want to write the file away and quit the editor, type :wq. A mes¬ 
sage like: 

"stuff** 50 lines, 3172 characters 

appears at the bottom of the screen. After you have quit the editor, you see the ‘tutorial^’ 
hostname prompt again. 

You can now use the editor to create a .cahrc file in your home directory to set the histdru and 
to contain aliases. 


4.6. Deleting or Changing Text 

There are several ways to delete and change characters and text. 


4 . 6 . 1 . Deleting Text with ^x^ 

The simplest command to use is the ‘delete character’ command x. If you want to delete five 
consecutive characters, you can do it in two different ways. You can either repeat the x five 
times, or you give the command a leading count and say 5x. 

However, if you change your mind, and want the characters replaced, the command you gave in 
the first place matters a lot. If you gave the fix command, you can get them all back with an 
undo command of u (described later). However, if you said xxxxx, the u command only undoes 
the last x command. To restore the line to its original state, use XJ. 

The difference between xxxxx and fix is also important if you are going to use (also described 
later) to repeat changes. 

You cannot delete characters beyond the end of a line. 
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4 . 6 . 2 . Deleting Words and Lines with *dw^ and *dd' 

To delete a whole word, position the cursor at the beginning of the word, and type dw. Again, 
you can give this command a count and delete more than one word at a time by typing Sdw, for 
instance. 

To delete a whole line, position the cursor anywhere on that line and type dd. The dd com¬ 
mand also takes a count, 5dd for example, to delete five lines. 

Uppercase D deletes from the cursor position to the end of a line. 


4 . 6 .S. Changing Text 

To change just one word of text, ‘dimensions’ from playfile for example, put the cursor on the 
beginning of the word and type cw. You see: 

/ diraension$ 

with the cursor on the first letter of ‘dimensions’ for example. The ‘$’ at the end of the word 
marks which word you are changing. Then type the word you want to substitute and ESC. This 
exchanges one word for the other and adjusts the space accordingly. 


4.7. Writing Your File and Quitting the Editor 

Consider the following ways to save ail your good work. Remember that you have to be in com¬ 
mand mode to do this, otherwise you’ll find yourself entering these characters into the file. 

To save your changes, type: 

iw 

We recommend typing :'w every few minutes while editing to insure that your changes are saved. 

If you want to save your changes and exit the editor, type any of the following: 

:wq 

or 

:x 

or 

ZZ 

Note the subtle differences here: :wq always writes out the file and then quits. The others ;x 
and ZZ only write the file out if changes are made, and then quit. If no changes are made, they 
quit without writing. 

Note also that with ZZ, you do not have to type RETURN. 

If you want to exit the editor without having made any changes, type: 

sq 

If you want to exit the editor without saving your changes, type: 

iq! 

The overrides any warning. If you are going to edit a file but might want to get back to the 
previous version, make a back-up copy of the file before running vt. 
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4,8. Correcting Mistakes with ‘u’ and ‘U’ 

When you make mistakes while making changes or adding text, there are two ‘undo’ commands, 
namely u and U, which make corrections easy. The lowercase u simply undoes the last change 
you made. If you have moved the cursor away from the position at which you did the change, 
the cursor is repositioned to its original place after the change has been undone. Similarly, if the 
screen has been moved since you did the change, it is moved back to its original display. The u 
command undoes any change to the edit buffer, even if that change affected many lines. 

Be careful. Giving another u command undoes the original ‘undo’ command, thus applying the 
change all over again, but you can undo that also if necessary. 

The uppercase U command can undo several changes, but only those made on the same line. 
Once you move the cursor off the line, however, you can no longer use a U on that line. 

Beware of using u and U in succession; the one does not undo the effects of the other. 
Remember that you can also use :q!. 


4.9. Repeating a Command with 

Use ‘ the period character, called ‘dot,’ to repeat a change, either at the same position or at 
the new position. 


4.10. Running Sun Commands from Inside the Editor 

When you need to return to the Shell temporarily to process a job or get some information, you 
don’t have to leave the editor. Simply type ;!command where command is the name of the com¬ 
mand you want. For example, to display your current directory from vi type: 

;!pwd 

/usr/evan 

Hit return to continue. 

The system displays the results of the command at the bottom of the screen, then prompts you 
with ‘Hit return to continue.’ 

You can also use the ez editor commands from vi. The ‘r’ (read) command, for example, adds or 
‘reads’ another file into the one you are editing with vi. The ‘r’ command adds the second file to 
the first after the current line, that is, the line where the cursor is in command mode. To be 
sure you know where the current line is, type a e<CR> on the line after which you want the 
second file to be placed. This marks the current line and repositions it at the top of the screen. 
When you type the colon character, it is echoed at the bottom of the screen. Whatever you 
type up to RETURN is interpreted as an ez command, and also echoed at the bottom of the 
screen as you type it. 

Use the ez ‘r’ command plus the name of the file you want to read in. For instance, to read in 
the file files into the existing playfile, type: 

:r files 

This puts files after the current line, that is, the line on which the cursor was before you typed 
:r files. Be sure you know what your current line is. The bottom line of the screen displays the 
number of lines read in. This is a handy way to join files. 
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To read the results of a Sun system command into the edit bufifer, type: 

:r !l8 -1 

for instance. This reads the current directory listing into the current file. 

You now have quite a bit of information in your playfile, so you can play around with several 
screens full to become more facile with vi. 


4,11. A Bit About the ‘ex’ Editor 

For the most part, you’ll probably use vi once you become handy with its facilities. However, 
the cx editor does have local and global text substitution capabilities that you can use from vi. 
For instance, if you decide to change the string ‘dollar’ in playfile to ‘greenback’, type: 

: /dollar / s/dollar /greenback / 

The first ‘dollar’ finds the string to change, and ‘s’ says to substitute for ‘dollar’ the string 
‘greenback’. This only changes the first occurrence of the string in a file. 

To change the first occurrence of the string ‘dimension’ to ‘measure’ in each line in the file, use 
the global substitution command ‘:g’: 

tg/dimension/s/dimension/measure/ 

Check through the playfile to see the result. Note that not only is the first ‘dimension’ now 
‘measure’, but the string ‘dimensionless’ is now ‘measureless’. Be careful how you specify the 
strings. This command does a global search for any string with the characters ‘dimension’ in it 
and substitutes ‘measure’ for the first occurrence in every line. 

To substitute ‘lint’ for every occurrence of ‘fuzz’ in every line, use: 

{g/fUEz/B/fUEz/llnt/g 

The first ‘:g’ command searches globally, and the second ‘g’ makes the substitution called by 
‘s/fuzz/lint/’ global as well. 


4.12. Other Text Editors 

The Sun system also supports the ed and sed editors. Ed is the interactive line editor that forms 
part of the basic UNIX system. Sed is the ‘stream editor’ that is similar to ed in the operations 
it performs, but it Is not interactive; it cannot move backwards in the edit file. You don’t use 
sed to make permanent changes in a file, but to ‘filter’ parts of a file as you do with the grep, 
sort, and awk utilities for example. 

Read more about these editors in Editing and Text Processing on the Sun Workstation. 
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Chapter 5 


Printing and Formatting Documents 


The most commonly used formatter on the Sun system is nroff. Nr off reads an input file con¬ 
taining unformatted text, interspersed with formatting requests and produces a neatly laid out 
document. The troff text formatter is an advanced program that produces output for a photo¬ 
typesetter. Troff h.si3 fine control over sizes of characters, multiple fonts, and so on. Troff and 
nroff are compatible, so it’s possible to prepare input acceptable to both. 

Basically, nrojfl^ makes all output lines the same length, and adjusts the spacing to justify the left 
and right margins. You can also select page size, number of lines on the page, length of the 
lines, size of margins, control indentation, center headings, and underline things. With the help 
of macros, either one uou make yourself or a package like -ms described later in this chapter, 
you can get footnotes, automatic generation of table of contents. This manual was formatted 
using -ms macros with troff. 

When you want to print something without any fancy formatting, headers or footers, use the Ipr 
command You used this before in piping the sorted play file to the line printer with: 

tutor ial% sort playfile | Ipr 
tutorial% 

The result is raw, unformatted text. 

The pr command ‘prepares’ a file for printing with running headers and footers, the filename, 
and the date and time the job is run. 

The fmt command is a simple text formatter command. Give it a number option, and it fills 
lines up to the given number of columns. 

Brief descriptions of these follow, but if you want something fancier, use nroff and troff. 


5.1. Printing a File with ‘pr’ and ‘Ipr’ 

The contents of a file can be printed using the pr and Ipr commands. The pr or ‘print file’ com¬ 
mand prints to the standard output, which is normally your workstation screen. An example of 
running pr on your playfile file and piping the output through more is: 
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tutor la 1% pr playfile j more 

Aug 6 11;20 1983 playfile Pago 1 

/ dimensions 

m *a* 

kg *b* 

sec *c* 

< etc, > 

township 36 mi2 
tun 8 barrel 

water .22491|2.54 kg/m2-sec2 

< etc, > 

Aug 6 11:20 1983 playfile Page 2 
wey 40 bu 
weymass 252 lb 
Xunit 1.00202-13m 
k 1.38047-16 erg/degC 
tutorial% 

Pr separates the output into pages and puts a five-line header at the top and a five-line trailer at 
the foot of each page. The trailer at the foot of the page consists of blank lines. In the header, 
one of the lines forms a title consisting of a date, the filename and a page number. The date 
shown in the header is the date the file was last modified. You can change the header by various 
options to the pr command. 

What pr really does is ‘prepare’ a file for printing. Generally you use pr in conjunction with the 
Ipr ‘line printer’ command, which routes files to the printer: 

tutorial% pr music j Ipr -Pprinter 
tutorial^ 

You can also call pr with the —p option of the Ipr command as follows: 

tutorial% Ipr -p —Pprinter music 
tutorial^ 

Lpr routes the named file(s), or the standard input if there are no named files, to the printer. It 
does nothing else, so your file is printed beginning at the very top of the page. Also, if your file 
takes more than one page, the printing carries over the perforations (assuming you are using con¬ 
tinuous form paper) without a break. This is why you use lpr in conjunction with pr. 

Only error messages are displayed on the workstation screen. The exact workings of this com¬ 
mand and its options vary from one installation to another, since they largely depend on the 
number and the types of printers available. See the Commands Reference Manual for the Sun 
Workstation for details on lpr. 

Your system has variations of the lpr command, or options to the command, which give you the 
capability of displaying the printer queue (usually the command variation Ipq) and removing 
requests from the queue (usually the command variation Iprm). 

The pr command has many options for preparing a file. See the pr details in the Commands 
Reference Manual. 
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5*2* Simple Text Formatting with ‘fmt’ 

Fmt is simple and fast. Try it on your playfile: 
tutor! a 1% fmt playfile 

/ dimensions m *a* kg *b* sec *c* coul *d* candela *e* 

dollar *f* radian *g* bit *h* erlang *i* degC *j* 

< etc. > 

'm2/sec2 tonne 1+6 gm torr mm hg township 36 mi2 tun 8 barrel 
water .22491|2.54 kg/m2-sec2 wey 40 bu weymass 252 lb Xunit 
1.00202-13m k 1.38047-16 erg/degC 
tutorial% 

Fmt makes the lines of text reasonably even in length. 


5.3. Running ‘nrofT 

After creating your file containing text to be formatted interspersed with formatting requests, 
format the output with nroff 2 i,nd pipe it through more for viewing on your workstation screen: 

tutorial% nroff file j more 

Now you can proofread it. Or you can print it by piping the output to the printer. 


5.4. A Package Deal — the ‘—ms’ Macros 

The macro package provides an easier way to format documents than basic nroff if you 
want something more than straight paragraphs. It provides indented block and itemized para¬ 
graphs, page headers and footers, and page numbering. 

Some examples of calls on —ms macros are: 

.LS 
.PP 
.NH 2 

.IP ‘first stanza' 14 
.LE 

As you will see, the — ma calls look very similar to nroff formatting requests. Each consists of a 
‘dot’ followed by two characters, optionally followed by arguments to the macro. All letters are 
upper case, and each macro call must be on a line of its own. It also must be the first thing on 
the line. 

Create a new file with the editor, perhaps using the king.art text below, and sample the —ma 
macros. Then format your file with nroff and the ma macro option: 

tutorial% nroff —ms filename \ more 
tutorial^ 

Here you have the most useful calls for basic document formatting. For the full selection, see 
the Editing and Text Proceaaing on the Sun Workatation. 
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5.4‘i- Paragraphs — \PP^ and \LP\ 

V/a provides two basic paragraph forms, an indented paragraph (that is, the first line is 
ndented), and a block paragraph. A standard paragraph example, unformatted and formatted 
s: 

tutorial% more king.art 
.PP 

King Arthur was at Caerleon upon Usk; 

and one day he sat in his chamber, 

and with him were Owain, the son of Urien, 

and Kynon, the son of Clydo, and Kay, the son of Kyner, 

and Guenever and her handmaidens at needlework by the window. 

In the centre of the chamber King Arthur sat, 
over which was spread a covering of 
flame-covered satin, 

and a cushion of red satin was under his elbow. 
tutorial% 

And the formatted version looks like: 

tutor ial% nr off — ma king.art 

King Arthur was at Caerleon upon Usk; 

and one day he sat in his chamber, 

and with him were Owain, the son of Urien, 

and Kynon, the son of Clydo, and Kay, the son of Kyner, 

and Guenever and her handmaidens at needlework by the window. 

In the centre of the chamber King Arthur sat, 
upon a seat of green rushes, 
over which was spread a covering of 
flame-covered satin, 

and a cushion of red satin was under his elbow. 
tutorial% 

For a left block paragraph, use the ‘.LP’ macro: 

tutor ial% more king.art 

King Arthur was at Caerleon upon Usk; 
and one day he sat in his chamber, 

and with him were Owain, the son of Urien, and Kynon, the son of Clydo, and Kay, th 
and Guenever and her handmaidens at needlework by the window. 

In the centre of the chamber King Arthur sat, 
upon a seat of green rushes, 
over which was spread a covering of 
flame-covered satin, 

and a cushion of red satin was under his elbow. 
tutorial% 

The formatted result is: 
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tutorial% nroff -ms klng.art 

King Arthur was at Caerleon upon Usk; 

and one day he sat in his chamber, 

and with him were Owain, the son of Urien, 

and Kynon, the son of Clydo, and Kay, the son of Kyner, 

and Guenever and her handmaidens at needlework by the window. 

In the centre of the chamber King Arthur sat, 
upon a seat of green rushes, 
over which was spread a covering of 
flame-covered satin, 

and a cushion of red satin was under his elbow. 
tutorial% 

If you don’t like these paragraph layouts, you can change them. Refer to the Editing and Text 
Processing on the Sun Workstation for details. 


5 .^.^. Quoted Paragraphs — \QP’ 

If you want a paragraph or paragraphs indented from the surrounding text at both the left and 
right edges, use the ‘.QP’ (quotation) macro: 

tutor!a 1% more mark.twain 
As Mark Twain wrote: 

.QP 

We should be careful to got out of an experience only the wisdom that is 
in it — and stop there; lest wo be like the cat that sits down on a 
hot stove lid. 

She will never sit down on a hot stove like again — and that is 
well; but also she will never sit down on a cold one any more. 

When formatted, this yields the following: 

tutorial% nroff -ms mark.twain 
As Mark Twain wrote: 

We should be careful to get out of an experience only the wisdom that is in it 
— and stop there; lest we be like the cat that sits down on a hot stove lid. She 
will never sit down on a hot stove like again — and that is well; but also she 
will never sit down on a cold one any more. 
tutorial% 

Try this now. 


5.4 S. Lists and Descriptions — \IP' 

Use the .IP macro to create the so-called ‘hanging indent’ type of paragraph, most commonly 
used for lists. You can give MP’ an argument, for instance, the number of a list item. To pro¬ 
duce a list, format your text as follows: 
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.IP 1. 


The 

' .IP’ 

macro 

creates 

lists 

that 

you 

can 

use 

in 

many 

documents. 

The 

‘ .IP’ 

macro 

creates 

lists 

that 

you 

can 

use 

in 

many 

documents. 

The 

" .IP’ 

macro 

creates 

lists 

that 

you 

can 

use 

in 

many 

documents. 

The 

.IP 

' .IP’ 
2. 

macro 

creates 

lists 

that 

you 

can 

use 

in 

many 

documents. 

The 

' .IP’ 

macro 

creates 

lists 

that 

you 

can 

use 

in 

many 

documents. 

The 

' .IP’ 

macro 

creates 

lists 

that 

you 

can 

use 

in 

many 

documents. 

The 

' .IP’ 

macro 

creates 

lists 

that 

you 

can 

use 

in 

many 

documents. 

The 

.IP 

" .IP’ 
3. 

macro 

creates 

lists 

that 

you 

can 

use 

in 

many 

documents. 

The 

' .IP’ 

macro 

creates 

lists 

that 

you 

can 

use 

in 

many 

doc\iments. 

The 

^ .IP’ 

macro 

creates 

lists 

that 

you 

can 

use 

in 

many 

documents. 

The 

' .IP' 

macro 

creates 

lists 

that 

you 

can 

use 

in 

many 

documents. 

The 

' .IP’ 

macro 

creates 

lists 

that 

you 

can 

use 

in 

many 

documents. 


The formatted version looks like: 

L The MP’ macro creates lists that you can use in many documents. 

The MP’ macro creates lists that you can use in many documents. 

The MP’ macro creates lists that you can use in many documents. 

The MP’ macro creates lists that you can use in many documents. 

2. The MP’ macro creates lists that you can use in many documents. 

The MP’ macro creates lists that you can use in many documents. 

The MP’ macro creates lists that you can use in many documents. 

The MP’ macro creates lists that you can use in many documents. 

3. The MP’ macro creates lists that you can use in many documents. 

The MP’ macro creates lists that you can use in many documents. 

The MP’ macro creates lists that you can use in many documents. 

The MP’ macro creates lists that you can use in many documents. 

You can also make a description list, where you see the name of something on the left of the 
page, and a paragraph describing it on the right. In this case, you give MP’ two arguments, the 
first argument is the name that is to appear on the left, and the second argument is how far to 
indent the text on the right. The unformatted version looks like: 

.IP Monday 12 

Finish debugging program. 

.IP Tuesday 12 

Meet with customers for demonstration. 

.IP Wednesday 12 
Discuss documentation plans. 

.IP Thursday 12 
Outline training class. 

.IP Friday 12 
Lunch with manager. 

When formatted, this looks like: 
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Monday 

Tuesday 

Wednesday 

Thursday 

Friday 


Finish debugging program. 

Meet with customers for demonstration. 
Discuss documentation plans. 

Outline training class. 

Lunch with manager. 



Relative Indents — '.RS' and \RE^ 

When you need to indent text in relation to previously indented text, use the ‘.RS’ and ‘.RE’ 
(relative indent start and end) macros. For example: 

.IP 1. 

pigs cows chickens ducks 
.RS 

• IP * 3 

pigs cows chickens ducks 
.IP * 3 

pigs cows chickens ducks 
.RE 

.IP 2. 

pigs cows chickens ducks 
.RS 

.IP * 3 

pigs cows chickens ducks 
.IP * 3 

pigs cows chickens ducks 
.RE 

when formatted looks like: 


1. pigs cows chickens ducks 

* pigs cows chickens ducks 

* pigs cows chickens ducks 

2. pigs cows chickens ducks 

* pigs cows chickens ducks 

* pigs cows chickens ducks 
This is particularly useful for outlines. 


5.^.5. Section and Paragraph Headings 

You can have numbered headings up to five levels and un-numbered headings. All headings are 
underlined by default (headings are made boldface if you are using troff), and may occupy 
several lines if required. 

o 
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5 , 4^5 Un-numbered Headings — ^.SH^ 

Use the ‘.SH’ (section heading) macro to introduce an un-numbered heading. For instance, the 
output: 

text and more text at the end of a paragraph. 

A Section Heading 

A new paragraph of text and more text 
that continues and continues and continues. 

was generated by using the formatting macros: 

text and more text at the end of a paragraph. 

.SH 

A Section Heading 
.PP 

A new paragraph of text and more text 
that continues and continues and continues. 

Put the macro on one line and the actual heading on the following line or lines of the input text. 
Begin the first paragraph following the heading with a ‘.LP’ or ‘.PP’ macro to signal the end of 
the heading. 



5.4‘5.2, Numbered Headings — ‘.NH’ 

To introduce a numbered heading, use ‘.NH’ implies a level 1 heading, and ‘.NH n’ where 

‘n’ is a number calls the corresponding level number. For instance, consider the formatting of 
this chapter in outline form: 

.NH 

Printing and Formatting Documents 
.LP 
.NH 2 

Printing a File with "pr’ and 'Ipr' 

.LP 
.NH 2 

Single Text Formatting with 'fmt' 

.LP 
.NH 2 

Running "nroff 

.LP 

.NH 2 

A Package Deal — the "—ms* Macros 

.LP 

.NH 3 

Paragraphs — ‘ .PP* and ' .LP* 

.LP 

When formatted, it looks like: 
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5. Printing and Formatting Documents 

5.1 Printing a File with and *lpr’ 

5.2 Simple Text Formatting with Tmt* 

5.3 Running ‘nrofiT 

5.4 A Package Deal — the ‘—ms’ Macros 
5.4.1 Paragraphs — ‘.PP’ and ‘.LP’ 


54,6. The Date — \ND^ and 

The -ma macro package automatically puts the date at the bottom of every page of your docu¬ 
ment. To avoid this, put the macro call ‘.ND’ at the beginning of your input text. 

To change the date shown on the bottom of every page, put the ‘.DA’ macro at the beginning of 
your input text; 

•DA 8 June 1982 

This also allows you to specify the exact format of date that you want, for example: 

.DA 1982-6-8 


54,7. Displays - \LE^ and 

A ‘display’ is some text that you want to appear as you typed it without any filling of lines, 
indented from the surrounding text, and kept together on the same page. Use the two macros 
‘.LE’ (display start) and ‘.LE’ (display end); the text that appears between these forms the 
display. Consider the following formatted text: 

King Arthur was at Caerleon upon Usk; 

and one day he sat in his chamber, 

and with him were Owain, the son of Urien, 

and Kynon, the son of Clydo, and Kay, the son of Kyner, 

and Guenever and her handmaidens at needlework by the window. 

In the centre of the chamber King Arthur sat, 
upon a seat of green rushes, 
over which was spread a covering of 
flame-covered satin, 

and a cushion of red satin was under his elbow, 

which was formatted by: 
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.LS 

King Arthur was at Caerleon upon Usk; 

and with him were Owain, the son of Urien, 

and Kynon, the son of Clydo, and Kay, the son of Kyner, 

and Guenever and her handmaidens at needlework by the window. 

In the centre of the chamber King Arthur sat, 
upon a seat of green rushes, 
over which was spread a covering of 
flame-covered satin, 

and a cushion of red satin was under his elbow. 

.LE 

You can further format your displays with the macros ‘.LE B’, which justifies the left margin, 
then centers the whole display, ‘.LE L’, which displays the text as is without indenting, and ‘.LE 
C’, which centers each line of text individually on the page. 

We used the ‘.LE’ and ‘.LE’ macros throughout this manual to offset the screen displays. 


5.^.8. Keeping Text Together — \KF^ and \KE* 

To keep lines of text together on one page, for a quotation, for example, use ‘.KS’ to mark the 
start of the text to be kept together (keep start), and ‘.KE’ (keep end) to mark the end of the 
text to be kept together. This is particularly useful for keeping the text of a table or list 
together for example. If there is not sufficient room on the current page for the formatted ver¬ 
sion of the text between these two macro calls, —mi starts a new page, leaving the remainder of 
the current page blank. An example looks like: 

.KS 

.IP Monday 12 

Finish debugging the conqailer. 

.IP Tuesday 12 

Meet with customers for demonstration. 

.IP Wednesday 12 

Discuss documentation plans. 

.IP Thursday 12 
Outline training class. 

.IP Friday 12 
Lunch with manager. 

.KE 

If you are working with text that must be kept together, but that need not immediately follow 
the reference to it, use the floating keep ‘.KF’ and ‘.KE’ macro pair. The text is kept together, 
and the remainder of the current page is filled with the following text. 
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.KF 

,IP Monday 12 

Finish debugging the con^iler. 

.IP Tuesday 12 

Meet with customers for demonstration. 

.IP Wednesday 12 

Discuss documentation plans. 

.IP Thursday 12 
Outline training class. 

.IP Friday 12 
Lunch with manager. 

.KE 



5 . 4 ^ 9 , Titles and Cover Sheets 

If you want to include a title and an author, or maybe even several authors on your document, 
use the ‘.TL’ macro to specify the title of the document and the ‘.AU’ macro to show the author 
or authors. Only the ‘.DA’ or ‘.ND’ macro calls to change or suppress the date may appear 
before these macros. 

Here is an example of calling the macros: 

.TL 

Beginner's Guide 
.AU 

Sonny Systems 
.NH 

GETTING STARTED 
.LP 

Sit down at your Sun Workstation. 

The first page of formatted text produced looks like: 

Beginner *8 Guide 

Sonny Systems 


1. GETTING STARTED 

Sit down at your Sun Workstation. 


5.4 10 . Overall Page Layout 

By default, —m» provides page numbers in the center at the top of each page of the form ‘-2-’. 
The run date appears at the bottom of each page when run with nro^. The top and bottom page 
margins are set to one inch. The line length is set to six inches, and there is no page offset. 
Many of these default parameters can be changed. See Formatting Documents with the —ms 
Macro Package in the Editing and Text Processing manual. 
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5.5. Laying Out Tables with ‘tbl’ 

Assume you have material that you want to lay out in tabular format, in rows and columns of 
text with captions, headers, and such. Numeric material requires column alignment different 
from alphabetic material. For this, use the tbl utility, which is a pre-processor for troff and for 
nroff. In general, the tbl capabilities can only be fully exploited when used in conjunction with 
troff, but some of the simpler aspects work with nroff. 

Use the ‘.TS’ and ‘.TE’ macros just as you do any other set of begin and end macros to bracket 
the desired text: 

.TS 

Description of the Table Layout 

Data to be Laid Out 

.TE 

Leaving out one or the other of this set can have all sorts of weird results on your output. 

The tbl processor sees a table in terms of three distinct parts: 

1. The overall layout or form of the table. For instance, whether the table is centered on 
the page, or whether the table is to be enclosed in a box. 

2. The layout of each line of data in the table. This part determines how each column in 
the table is laid out. For instance, whether it is left-adjusted, or centered, or whether 
numeric data must be aligned on the decimal point. 

3. The actual data (the textual material) of the table itself. 

Study the following simple example: 

,TS 

tab (/) ; 

111 . 

Franz Joseph Haydn/1732/104 
Wolfgang Amadeus Mozart/1756/41 
Ludwig van Beethoven/1770/9 
Franz Schubert/1797/9 
Johannes Brahms/1833/4 
Gustav Mahler/1860/9 
.TE 

The line with tab (/) ; on it is the so called ‘options’ part of the table. This is the first part in 
the list above. In this particular case, the only option to tbl is to tell it that the ‘tab’ character is 
to be a slash character. Normally, tbl expects to see the columns of data in the data part of a 
table separated by real tab ("I) characters. Our example uses a visible character that is not part 
of the data, the slash character /, in this case because it’s easier to see what’s going on. Ter¬ 
minate the options part of the table by a semicolon. 

The next part of the table header is the description of how the actual columns of data are to be 
laid out, part 2 from the list above. In this case, there are three left-adjusted columns, indicated 
by the I format letters. You can have many lines of format descriptions. Each line of format 
description in part 2 of the table corresponds to a single data line in part 3, the data part of the 
table. If, however, there are more lines of data in the data part of the table than there are for¬ 
mat description lines, the last line of the format description part applies to all the remaining 
lines of the data. Here, the three letter / format letters apply to every line in the data part of 
the table. Terminate the format descriptions with a period at the end of the last one. 
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Then add the actual data of the table, each field of which is separated from the next by the / 
character. Here you learn the birthdates and number of symphonies composed by several well- 
known classical composers. 


Now create a file called mustc with this text, format the table and display it for viewing by typ¬ 
ing: 

tutorial% tbl mustc { nroff —ms | more 


Franz Joseph Haydn 1732 
Wolfgang Amadeus Mozart 1756 
Ludwig van Beethoven 1770 
Franz Schubert 1797 
Johannes Brahms 1833 
Gustav Mahler 1860 


104 

41 

9 

9 

4 

9 


You can of course also redirect the output to a file with or give tbl a list of files, which are 
processed one by one in the order in which you specified them on the command line. Here the 
table appears on the left hand side of the page. You probably would prefer it centered in run¬ 
ning text, in which case you add a center option to the options part of the text: 

.TS 

center tab (/) 

111 . 

Franz Joseph Haydn/1732/104 
Wolfgang Amadeus Mozart/1756/41 
Ludwig van Beethoven/1770/9 
Franz Schubert/1797/9 
Johannes Brahms/1833/4 
Gustav Mahler/1860/9 
.TE 

When formatted, this looks like: 

tutorial% tbl music { nroff —ms { more 

Franz Joseph Haydn 
Wolfgang Amadeus Mozart 
Ludwig van Beethoven 
Franz Schubert 
Johannes Brahms 
Gustav Mahler 


1732 104 

1756 41 

1770 9 

1797 9 

1833 4 

1860 9 


To align numerical entries, you must treat numbers as numbers, not just as any character. 
Change the format specification letters for the birthdate and number of symphonies: 

,TS 

center tab (/) ; 

Inn. 

Franz Joseph Haydn/1732/104 
Wolfgang Amadeus Mozart/1756/41 
Ludwig van Beethoven/1770/9 
Franz Schubert/1797/9 
Johannes Brahms/1833/4 
Gustav Mahler/1860/9 
.TE 


Revision A of 15 April 1985 


5-13 



Printing and Formatting Documents 


Beginner's Guide 


The format specification part indicates that the second and third columns are numerically (‘n’) 
aligned columns so the data in the second and third columns of each line is aligned properly to 
the right. The formatted version looks like: 

tutorial% tbi music | nroff —ms [ more 


Franz Joseph Haydn 

1732 

104 

Wolfgang Amadeus Mozart 

1756 

41 

Ludwig van Beethoven 

1770 

9 

Franz Schubert 

1797 

9 

Johannes Brahms 

1833 

4 

Gustav Mahler 

1860 

9 


To add captions for the individual columns, see what has been included in the following: 

.TS 

center tab {/) ; 

c c c 

Inn. 

Conposer/Birthdate/No. of Syn^honies 
.sp 

Franz Joseph Haydn/1732/104 
Wolfgang Amadeus Mozart/1756/41 
Ludwig van Beethoven/1770/9 
Franz Schubert/1797/9 
Johannes Brahms/1833/4 
Gustav Mahler/1860/9 
.TE 

The example above now shows an extra line in the format description part, and some extra data 
in the data part. The first line of the format descriptions indicates that there are to be three 
columns of data, each one centered within its column. This format applies to the very first line 
of the data. The second (and last) line of the format description part is the same as before, and 
it applies to all the remaining data lines in the table. 

This new layout looks like: 

tutorial% tbl music | nroff —ms | more 

Con^oser Birthdate No. of Symphonies 


Franz Joseph Haydn 1732 104 
Wolfgang Amadeus Mozart 1756 41 
Ludwig van Beethoven 1770 9 
Franz Schubert 1797 9 
Johannes Brahms 1833 4 
Gustav Mahler 1860 9 


By the way, when you describe a table, the format description part, part 2 of the table, must 
always describe the largest number of columns which that table has. If there are some lines 
which have fewer columns of data, you must indicate what to do with those specific lines. 

You can also print a table with a centered overall heading line for the entire table. This is called 
a ‘spanned heading,’ meaning that that a column of data spans across into the next column. 
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.TS 

CGnt©r tab (/) ; 

css 
c c c 
Inn. 

Music Trivia 

.sp 

Con^joser/Birthdato/No. of Syn^ihonies 
.sp 

Franz Joseph Haydn/1732/104 
Wolfgang Amadeus Mozart/1756/41 
Ludwig van Beethoven/1770/9 
Franz Schubert/1797/9 
Johannes Brahms/1833/4 
Gustav Mahler/1860/9 
.TE 

Here the result is: 

tutorial% tbl music j nroff —ms | more 

Music Trivia 

Conposer Birthdate No. of Symphonies 


Franz Joseph Haydn 1732 104 
Wolfgang Amadeus Mozart 1756 41 
Ludwig van Beethoven 1770 9 
Franz Schubert 1797 9 
Johannes Brahms 1833 4 
Gustav Mahler 1860 9 


The first line of the format description part now shows a centered, spanned column. A spanned 
element can span as many or as few columns as you like. 

Read the Editing and Text Processing on the Sun Workstatin for the details of tbPs other capabil¬ 
ities. 


5.6. Formatting Mathematical Equations with ‘eqn’ 

The eqn and neqn packages aid preparation of documents containing mathematical equations. 
Eqn is a preprocessor for troff, and neqn is a preprocessor for nroff. The preprocessors set the 
mathematics while troff and nroff do the text of a document. These turn English-like descrip¬ 
tions of an equation into the formatting request for generating the mathematical symbols for that 
equation. The capabilities are restricted by the limitations of typewriter-like printers. Enclose 
equations with ‘.EQ’ and ‘.EN’ to tell eqn where the equations begin and end, A simple example 
is: 


.EQ 

x=y+z 

.EN 

which produces: 
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x^y^z 

You can print mathematical symbols and names and the Greek alphabet with eqn, 
•EQ 

x=2 pi int sin ( omega t)dt 
.EN 

which produces: 


i=27rjsin(u?f)rfi 

(Note that your printer may not handle these fancy fonts.) You can also produce superscripts 
and subscripts for example with the words sup and sub: 

.EQ 

y = c sub 1 X sup 2 + c sub 2 x + c sub 3 
.EN 

which produces: 


y-CiX^-i-c^x+c^ 

eqn does not process ‘.EQ’ and ‘.EN’ other than to take care of the equation between them. So 
you have to center, number, and justify the equations yourself or use eqn in conjunction with the 
—ms macro package, which as you know, takes care of those things for you. See Editing and 
Text Processing for details. 


5.7, Formatting with ‘nrolF or ‘trofF 

Prepare the input file, using an editor, and embed the nr off or troff requests in the text of the 
document to be formatted. Put each request itself at the beginning of a line. A request cannot 
appear on the same line as the text to be formatted, although sometimes part of the text to be 
formatted can be given as an argument to a request, A formatting request consists of a basic 
nr off instruction, (a period or ‘dot’ followed by one or two characters), or a call to an nr off 
macro, optionally followed by one or more arguments separated by spaces. 

Some examples look like: 


.sp 
.po 8 
.bp 
.in 5 
.ti -3 
.in +5 
.ce 4 
.ul 


Putting a space between the instruction and any numerical value that an argument may take 
makes the requests easier to read, although it’s not necessary. 

An argument may also be a number preceded by a plus sign or a minus sign. This means a 
change relative to the existing value of whatever it is you’re altering. For example,, ‘.in +5’ 
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means indent the margin 5 spaces more than what it is now, and similarly ‘.in —4’ means back off 
that indent by 4 spaces. 


5.7.1. Page Breaks — 

To do your own page breaks, insert the ‘.bp’ (break page) at strategic points in your document. 
The macro package automatically does this, but sometimes you may want to force a new page. 

5.7.2. Blank Lines — ‘.sp* 

You can put blank lines in the output by using the ‘.sp’ request. The appropriate number of 
blank lines are left in the output text. For example, to put three blank lines between sentences, 
use ‘.sp 3’: 

King Arthur was at Caerleon upon Usk; 

and one day he sat in his chamber, 

and with him were Owain, the son of Urien, 

and Kynon, the son of Clydo, and Kay, the son of Kyner, 

and Guenever and her handmaidens at needlework by the window. 

.sp 3 

In the centre of the chamber King Arthur sat, 
upon a seat of green rushes, 
over which was spread a covering of 
flame-covered satin, 

and a cushion of red satin was under his elbow. 

which when formatted is: 

King Arthur was at Caerleon upon Usk; 

and one day he sat in his chamber, 

and with him were Owain, the son of Urien, 

and Kynon, the son of Clydo, and Kay, the son of Kyner, 

and Guenever and her handmaidens at needlework by the window. 


In the centre of the chamber King Arthur sat, 
upon a seat of green rushes, 
over which was spread a covering of 
flame-covered satin, 

and a cushion of red satin was under his elbow. 

An ‘.sp’ request with no argument leaves one blank line in the output. Or you can produce a 
blank line by just leaving blank lines in the input text. Using ‘.sp’ is better because it is easier to 
change later if you decide to add more or fewer blank lines. 


5.7.$. Centering and Underlining — \ce' and \uV 

Use the ‘.ce’ request to center lines of text. The ‘.ce’ request without an argument centers one 
line, for example: 
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.ce 

Beginner's Cuide 
centers the following line of text: 

Beginner’s Guide 

To center more than one line of text, type: 

. ce 3 

ducks chickens 
cows ducks chickens 
pigs cows ducks chickens 

centers the following three lines of text: 

ducks chickens 
cows ducks chickens 
pigs cows ducks chickens 

Filling is temporarily turned off when lines are centered, so each line in the input appears as a 
line in the output, centered between the left and right margins. 

If you don’t want to count how many lines you want centered, use the ’.ce’ request with a 
number greater than the maximum number of lines you think you want centered. In the follow¬ 
ing example, use the number 100: 

.CO 100 

Some random number of text lines 
< etc. > 

.ce 0 

The \ce 0’ request simply stops the centering process. 

Note that the argument to the ‘.ce’ request only applies to following text lines in the input. 
nroff request lines are not counted. 

Underlining is somewhat misleading, for nroff underlines and troff italicizes the words. If you 
want to ‘underline’ a heading for example, and format the text with nroff, use the ‘.ul’ nroff 
request, and type: 

.ul 

ducks 

which underlines as: 
ducks 

You can use the same numbering count with ‘.ul’ as with ‘.ce’. 

You can of course also this to emphasize single words: 

The best way to learn a new system is 
not just to read about it^ but to 
.ul 
use 

the facilities it provides. 

troff produces: ‘The best way to learn a new system is not just to read about it, but to use the 
facilities it provides.’ Notice that you have to arrange your input so that the word you want 
underlined appears on a line of its own. 
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Indentation — ‘.in' 

To indent lines of text, use the ‘.in’ request. For example, ‘.in 5’ indents all following lines five 
spaces. 

.in 5 

King Arthur was at Caerleon upon Usk; 

and one day he sat in his chamber, 

and with him were Owain, the son of Urien, 

and Kynon, the son of Clydo, and Kay, the son of Kyner, 

and Guenever and her handmaidens at needlework by the window. 

. in 0 

In the centre of the chamber King Arthur sat, 
upon a seat of green rushes, 
over which was spread a covering of 
flame-covered satin, 

and a cushion of red satin was under his elbow. 

Use ‘.in 0’ to turn off the indent. 

King Arthur was at Caerleon upon Usk; 

and one day he sat in his chamber, 

and with him were Owain, the son of Urien, 

and Kynon, the son of Clydo, and Kay, the son of Kyner, 

and Guenever and her handmaidens at needlework by the window. 

In the centre of the chamber King Arthur sat, 
upon a seat of green rushes, 
over which was spread a covering of 
fiame-covered satin, 

and a cushion of red satin was under his elbow. 


5.7.5. Temporary Indents — ‘./i' 

For a temporary indent in relation to the current, use the ‘.ti’ (temporary indent) request. This 
works on the following line only. For example: 

.ti 5 

King Arthur was at Caerleon upon Usk; 

and one day he sat in his chamber, 

and with him were Owain, the son of Urien, 

and Kynon, the son of Clydo, and Kay, the son of Kyner, 

and Guenever and her handmaidens at needlework by the window. 

produces: 

King Arthur was at Caerleon upon Usk; 
and one day he sat in his chamber, 
and with him were Owain, the son of Urien, 
and Kynon, the son of Clydo, and Kay, the son of Kyner, 
and Guenever and her handmaidens at needlework by the window. 
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5.7.6. Filling — and 

If you don’t want lines filled in, use the ‘.nf’ (no fill) request. Lines are still left justified. To 
turn filling back on after you’ve entered text, type the ‘.fi’ (filling) request. The formatted ver¬ 
sion follows the unformatted version here. 

King Arthur was at Caerleon upon Usk; 
and one day he sat in his chamber, 
and with him were 
.nf 

Owain, the son of Urien, 
and Kynon, the son of Clydo, 
and Kay, the son of Kyner, 
and Guenever 

and her handmaidens at needlework by the window. 

.fi 

In the centre of the chamber King Arthur sat, 
upon a seat of green rushes, 
over which was spread a covering of 
flame-covered satin, 

and a cushion of red satin was under his elbow. 

King Arthur was at Caerleon upon Usk; and one day he sat in his chamber, 

and with him were 

Owain, the son of Urien, 

and Kynon, the son of Clydo, 

and Kay, the son of Kyner, 

and Guenever 

and her handmaidens at needlework by the window. 

In the centre of the chamber King Arthur sat, upon a seat of green 
rushes, over which was spread a covering of flame-covered satin, and a 
cushion of red satin was under his elbow. 



O 
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The Sun system provides several facilities for communicating with local and remote hosts. You 
can use mail to send messages, which your friends can read at their leisure, save and respond to 
as necessary. For a quick message, there’s the write command that sends the message to another 
user immediately. The network news provides a widely distributed network for communicating 
news items. The tip utility provides dial-up phone access to other systems. For more informa¬ 
tion on mail and the network news, refer to the Mail User*s Guide and the Network News User’s 
Guide in Part Two of this manual. For information on write and tip, see the Commands Refers 
ence Manual for the Sun Workstation, 

For set-up instructions on either of these two facilities, refer to the System Manager’s Manual 
for the Sun Workstation. 


6.1. The Electronic ‘mail’ System 

When you send mail to another user, the messages pile up in a ‘mailbox.’ If your recipient is 
logged in and has set mail set in his .login file, he is notified that mail has arrived when he com¬ 
pletes whatever command he is using at the time. If he is not logged in, your message is saved in 
the mailbox file, and the recipient is notified that he has mail the next time he logs in. 

The mail program keeps track of what you do with your mail; it records whether you throw a 
message away, save it in your mailbox, write it to a separate file, or respond to it, for example. 

When you log in, or sometime during a work session, you will receive the message: 

You have mail. 


or 


You have new mall. 

indicating that you have mail in your ‘mailbox.’ 


6.1.1. Reading Your Mail 

To read your mail, type: 
tutorial% mail 

Mail version 2.17 12/26/82. Typo ? for help. 

''‘/usr/spool/mail/evan* ' : 1 message 1 unread 
>U 1 loriOtutorial Tue Oct 29 12:43 
& 

The system responds with a numbered list of messages. To read your mail, type either RETURN 
for the next message or: 
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& P 

From lori Fri May 4 21:20:03 1983 
Date: 4 May 83 21:19:54 PDT (Fri) 

From: lori (Lori Rosen) 

Message-Id: <8307020419 .AA01512(i)sun .uucp> 

Received: by sun.uucp (3.320/3.14) 

id AA01512; 4 May 83 21:19:54 PDT (Fri) 

To: evan 
Status: R 

Are you going to the birthday party this evening? 

I need a ride. 

& 

for the current message, or pn where the number n is for the message of that number. The 
example above is an approximate representation as the message heading varies with who sent 
you the mail, from what system, and so on. 

To save the message in a file for future reference, type: 

& s filename 

where filename is your chosen filename. Note that this appends the message to the named file 
and does not overwrite any existing contents. 

To quit the mail program and have your mail correspondence updated automatically on what 
messages you have and ha\e not read, type: 

& q 

To delete the message you just read, type: 

& d 

To delete a specific message, number 5 for instance, type: 

& dS 

Your mail is erased, unless you ‘undelete’ a specified message with the « command before you 
leave mail. 

And if you want to leave mail and get back to the Shell without making any changes to your 
messages or reading any of your mail, type: 

& X 

for ‘exit.’ Any deleted messages are undeleted. 

You can get help at any time during this correspondence by typing a sign, and mail displays a 
quick and dirty summary of the most helpful responses. 
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Table 6-1: Mail Quick Summary 


& r 


c <directory> 
d <message Iist> 
e <message list> 
f <message list> 
h 

m <user Iist> 
n 

p <message list> 
pre <message list> 

q 

r <message Iist> 

R <message list> 
s <message Iist> file 
t <message Iist> 
top <message list> 
u <message list> 
w <message list> file 

X 

! 


chdir to directory or home if none given 
delete messages 
edit messages 

show from lines of messages 
print out active message headers 
mail to specific users 
goto and type next message 
print messages 

make message go back to system mailbox 
quit, saving unresolved messages in mbox 
reply to sender only of messages 
reply to messages 
append messages to file 
type messages (same as print) 
show top lines of messages 
undelete messages 

append messages to file, without from line 
quit, do not change system mailbox 
shell escape 


A <message list> consists of integers, ranges of same, or user names separated 
by spaces. If omitted, Mail uses the last message typed. 


6.I.S. Replying to Mail 

There are two ways to reply to mail. You can type an ‘r’, which sends a response only to the 
sender of the message and not to any of the names listed as Cc:’s (more on this later). 

Or, you can type a ‘R’ to respond to everyone who received the original message. To reply to 
the sender only, type: 

& reply 

at the mail prompt or just ‘r’ for short. 

& r 

To: lori 

You see the message header ‘To: lori’ for example, and you can type in your response, ter¬ 
minated by a "D. 

6.1.2.1. Your Own Mailbox or *mbox^ 

To save the mail in your mbox (mailbox) file, type: 

& q 

for ‘quit’ when you are done reading your mail. This appends any messages you have read, but 
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not deleted during the current session to the mbox file in your home directory or creates the file 
the first time you use ‘quit’. Also, any messages you have saved are deleted rather than added to 
your mbox. 


6.1.3. Sending Mail 

Assuming that you are using the Sun system network, and that you are sending mail to one of 
your colleagues on another host system, use the mail command and indicate the recipient and his 
hostname. For instance, to send mail to ‘kathy’ whose hostname is Venus,’ type: 

tutorial% mall kathy@venu» 

We are moving the project due date up one week. 

Let me know if this causes a problem. 

EOT 

tutorial% 

Ask your system administrator for the names of other users’ hosts. 

To send mail to someone with an account on the same system is even easier. Assuming you are 
logged in to ‘angel’ and want to send mail to Steve, who also has an account on ‘angel’, simply 
type: 

angel% mail stcve 

Will you be out of town on business next week? 

"D 

angel% 

Try sending mail to yourself. Be patient; mail delivery is not instantaneous, and it often takes a 
few seconds for you to be notified that ‘You have new mail.’ {Mail is handled by a background 
process.) 


6 . 1 . 4 . Personalizing Your Mail in Your .mailrc File 

Just as you have a .login and a .cskrc file in which you can customize your account, you can also 
create a .mailrc file in your home directory to prompt you for additional information in messages 
and to provide the same kind of alias shorthand as in your .cshrc file. 

If you would like to be prompted for a ‘Subject:’ header, include the ‘ask’ option in your .maiVrc 
file: 

set ask 

Now try sending yourself mail as follows: 

tutorlal% mail lorl 

Subject : Sending Mail 

This shows how to get a ‘Subject:* header 

when sending mail. 

"D 

tutorial^ 

If you want to send copies of a letter to other users, edit your .mailrc file to include: 
set askcc 

which will then prompt you with ‘Cc:’ when you terminate a message with "D. Again, try it on 
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yourself: 

tutorial% mall lori 
Subject: Sending Copies 
This shows how to send copies 
of messages. 

Cc: Chris 
tutorial% 


Distribution Lists and Aliases 

As you learned in the chapter on Using the Shell, you can set aliases for long lists of commands 
or names. This is particularly useful here for distributing copies of letters to the various 
members of a project group for instance. 

Put an ‘alias’ in your ,maUrc file, for example: 

alias gang jon tom marty Steve evan@venus 

which specifies the members of a particular project. 

tutorial% mail gang 
Subject: PrlorItles 

It is critical to get the product completed by November. 

"D 

tutorial% 

Remember that all these message recipient names are really login names, but the alias may 
include ‘evan@venus’ for mailing to remote hosts. 


6.2, Writing to Other Users with ‘write’ 

The write command immediately sends a message to a specified user, when you type the mes¬ 
sage, provided that the recipient is logged in to the same system at the time. Use u>rl^e only 
when it’s a real emergency because it does bother some people when messages start appearing 
while they’re trying to type at the workstation. 

If your recipient is logged in over a phone line, their phone will be continuously busy, so write 
may be the easiest way to reach them. 

A typical example of how to use write is: 

tutorial% write Joann 
Is the customer demo ready? 

tutorial% 

You are not prompted after you type write and the login name, so simply type in the message 
you want to send, as many lines as you like, and end it with the end-of-text character, "D. You 
don’t get any indication that your message has actually been received. 

What the recipient, "joann”, sees is: 
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Message from tutorial!brad on tty08 at 10:42 ... 

Is the customer demo ready? 

EOF 

‘tutorial’ is the hostname of the system that Joann and Brad are using. The EOF indicates that 
the message is finished, and Brad has quit writing. 

This is a simple one-line message, but if you send more than one line, your recipient doesn’t get 
it all at once. He sees each line only after a RETURN is typed, so the EOF is the only indication 
that the message is complete. This causes problems for a two-way conversation, which is usually 
what you’ll use. For example, suppose Brad tries to get in touch with Jay: 

tutor ial% write jay 

but doesn’t immediately enter the message to see if Jay is logged on. Jay receives a message that 
says: 

Message from tutorial!brad on ttyOS at 10:45 ... 

At this point Jay gives his own write command: 

tutorial% write brad 
Hi. Whatr 

Jay doesn’t type "D, so now Jay and Brad are ‘talking’ to each other, until one of them types "D 
to drop out of the conversation. 

At the end of the conversation. Brad’s screen might look like this: 

tutorial% write jay 

Message from tutorial!jay on tty04 at 10:45 ... 

Hi. What? 

How about discussing the project this afternoon? 

There's a department meeting. Sorry. 

Maybe tomorrow 
morning? 

Sounds good. 

‘D 

tutorial% 

What Brad has typed is shown boldface. Jay’s replies are in normal type. Jay’s screen looks like: 

tutorial% Message from tutorialIbrad ttyOS at 10:45 ... 

write brad 
Hi. What? 

How about discussing the project this afternoon? 

There’s a department meeting. Sorry. 

Maybe tomorrow 
morning? 

Sounds good. 

EOF 

•D 

tutorial% 

Here we have shown what Jay typed boldface, and Brad’s contributions in normal type. Here 
the dialogue consisted of simple one-line questions, but if you are going to provide several lines of 
information rather than ask questions, use the protocol, which suggests that you terminate each 
message with the character o, for ‘over’, and when you are about to quit the conversation, type 
oo, for ‘over and out’. You can also set up your personal protocol with your colleagues. 
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If you try to write to someone who is not logged in, you get a message: 

tutor ial% write sylvla 
Sylvia not logged in. 
tutorial% 

and write terminates. You get the same response if you try to write to someone who is not a 
user, because write doesn’t check for known system users, only for users logged in. Remember 
that you can always use the who command to see who is logged in: 


tutorial^ who 


susan 

ttyOO 

08:30 

henry 

tty03 

08:31 

jay 

tty04 

09:05 

susan 

tty06 

09:15 

hank 

tty07 

09:15 

brad 

tty08 

09:10 

tutorial% 



If you have already started typing your message when the system finds that the user is not 
logged in, and decides to ignore your command, cancel what you have typed using your line kill 
character (^U). This is not critical, but it can be disconcerting when the system tries to inter¬ 
pret your partial message as a command next time you press RETURN. 

You may try to write to someone and get the response: 

tutorial% write h&nk 
Permission denied. 
tutorial% 

This means that the recipient is using one of the system commands that ‘locks out’ the write 
command to prevent messages from messing up nicely formatted output. This is the same mes¬ 
sage you get if you try to write to a user who has used me^g to prevent you writing to his works¬ 
tation. Mesg is described later. 

What’s really happening here is that you are writing to the user’s workstation or terminal, for 
example, to tty08, where our who example shows Brad is logged in. 

The example of the who command shows that the user ‘susan’ is logged in to the system twice, 
once on ttyOO, and again on ttyOfi. Choose one, and if you don’t get a response, quit that write 
and try to get the user on the other: 

tutorial% write susan ttyOO 
Are you there? 

-D 

tutorial% write susan ttyOO 
Are you there? 

Message from tutorial!susan ttyOO... 

Yes. What’s up? 

Working late? 

Yes. See you tomorrow. 

EOF 

"D 

tutorial% 

If you don’t specify a terminal, chooses one for you: 
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tutorial% write susan 
susan logged more than once 
writing to ttyOO 

Writt chooses the lowest number terminal, so if you don’t get a response there, specify the par¬ 
ticular tty number to get messages sent to the other terminal. 

If you have a long message to communicate, use a text editor to prepare the message in a file and 
correct any mistakes before anyone else sees them. Send this message by redirecting the Stan¬ 
dard Input: 

tutorial% write jay < message 
tut:orial% 

The recipient receives the message all at once. There is no waiting between lines, as there is 
when the message is typed following the write command. Use the mail command described 
above to send very long messages so your recipient can choose his own time to read them. 

Here as in the editor, you can use the exclamation mark character / to call a system command. 
For instance, suppose you want to find the location of some files and let someone else know. You 
change to the desired directory and start writing. If you forget the name of the directory, you 
can find out in the middle of writing by saying: 

tutorial% write Joe 

The files you want are in the directory: 

!pwd 

/dd/project/brad/docs/memos 
! 

/dd /project /brad / docs/memos 
tutorial% 

You still have to type in the output of the command called by Of course, the command you 
give following ‘!’ may have nothing to do with the message you are sending. You may also 
redirect the Standard Output of the command, so you don’t see any output on the screen. The 
second M’ signals command termination. 


6.3. Preventing Message Interruptions with ‘mesg’ 

If you dislike being interrupted by your friends’ messages while you are programming at your 
workstation and especially when you are using a text editor, set the mesg command to ‘n’ to stop 
incoming messages: 

tutorial% mesg n 
tutorial% 

This ‘no’ tells the system to prevent someone else from writing to you. The message sender sees: 
Permission denied. 

The default is ‘yes’, and you can check how yours is set by typing: 

tutorial% mesg 
is y 

tut:orial% 

As a first-time user, yours is undoubtedly still enabled. Setting me^g to ‘no’ only lasts for your 
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current login session unless you set it permanently. To do this, edit your your .login file to 
include: 

mesg n 


6*4* Network Facilities 

Your Network File System lets you mount a file system from a remote system onto your own 
machine, where you can work on it as you will. If you need to access a machine that is not part 
of the Network File System, you must log in to the system to copy files or do work. 

When you want to access information on another machine, try the procedure given in Using the 
Network File System described below. If the procedure given there doesn’t work, try logging in 
to the remote system or using the remote commands discussed below. 


Using the Network File System 

To mount a file system from another machine onto your machine, type the following: 
tutorial% 8U 

tutorial% your superuser password 

tutorial% /etc/mount remote-pathname local-pathname 
tutorial% 

For a concrete example, let’s suppose you don’t have any games on your system and you have a 
sudden urge to play some. In this example, games are located on another machine named panic. 
To get the games onto your machine give the command 

tutorial% 8U 

tutorial% your superuser password 

tutorial% /etc/mount panic:/usr/games /usr/games 
tutorial% 


Making Connections with Wlogin' and Wsh* 

Use the rlogin (remote login) command to log in to another system. For example, to do a remote 
login to the ‘angel’ system from your host ‘tutorial,’ use the rlogin command: 

tutorial% rlogin angel 

Last login: Mon Jul 11 22:23:40 am ttypO 

Sun UNIX 4.2 (UNIX) (SUN) #4: Fri Jan 11 00:20:28 PST 1985 
angel% 

You can then login as you normally do, although a password is not necessary if you log in as the 
same user on an equivalent host. In both cases, your local user name must exist on the remote 
host to allow remote command execution as there isn’t any password prompt. Your system 
administrator sets this up for you. 

You can write to another user on the system or send mail without having to provide a hostname 
if you’re on the same system. 
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Log out as you normally do: 

angel% logout 
Connection closed. 
tutorial% 

You can go on with your local work as before. 

If you want to execute a single command on another system, use the rsh (remote Shell) com¬ 
mand. For instance, to find out who is logged in on ‘angel’, say: 

tutorial% rsh angel who 

lori console Jul 28 09:48 

tutorial% 


6.^,3. Copying Files From Other Systems with 'rep' 

Your local network also allows you to copy files from one system to another with the rep (remote 
copy) command. For example, if you need one of your colleague’s files from another system, 
type: 

tutorial% rep krypiont/usr/henry/zniac/plan . 
tutorial% 

This copies from Jusrjhenryfmisc on system ‘krypton’ the plan file into your current (or dot ‘.’) 
directory on your host ‘tutorial’. If you need to copy a directory with its contents, use the —r 
(recursive) option: 

tutor ial% rep —r kryptont/uBr/henry/mlsc . 
tutorial% 

This copies all of the misc directory, including any subdirectories and files, into your current 
directory. 

Note that if you’re using ‘[ )’, ‘"’j ‘>’, “’or as with rsh, you must enclose the 

path in quotes. For example: 

tutorial% rep —r Vcnusr/usr/kathy/misc/chap*’. 
tutorial% 

This quotation prevents some strange and undesirable filename expansion. 


6.5« Additional Communication Facilities 

The Sun system supports several additional communication facilities for which detailed descrip¬ 
tions are beyond the scope of this manual. We introduce these facilities to you here and recom¬ 
mend that you read the indicated documentation and the Commands Reference Manual pages 
for instructions on how to use them if you are interested. 

The UUCP (UNK-to-UNDC copy) utility provides networking of machines over phone lines. The 
mail facility uses it to send mail to users at remote sites and the network news facility described 
below uses it to transmit news articles. The tip facility permits file transfers between machines. 
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6.5.1, Ne two rk Ne ws 

The network news, or simply netnews, provides access to the USENET (User’s Network). Netnews 
is a communication facility for sharing information among a large number of users. It can be 
described as an electronic bulletin board. You can send articles from one machine to another for 
limited or very wide distribution, post an article to interested persons, browse through old news, 
post follow-up articles, and send direct electronic mail replies to the author of an article. You 
can select the articles, which are arranged in categories called newsgroups. 

See the Network News User’s Guide in Part Two of this manual for details. 


6.5.2. Dialing to Remote Systems with Up* 

With the tip utility, you can dial in with a phone hook-up to a remote system to transfer files 
from one machine to another. You must have a login name on the remote machine. You can 
use either the name of the remote system or the phone number with the tip command to make 
the connection. 

A typical example is: 

tutorial% tip tymnet 
dialing ... connected 

Or you can use the phone number of the desired system by typing: 

tutorial% tip XXXXXXXXXX 

dialing... connected 

where XXXXXXXXXX is the phone number. Ask your system administrator for specific details. 

Occasionally, you may receive the response: 

dialing ... no answer 
EOT 


or 

all ports busy 

which can mean a number of things, such as all outgoing lines are busy. 

A tilde at the beginning of a line is the escape character. 

To logout, type 

For a full description of tip, refer to the Commands Reference Manual for the Sun Workstation. 
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Preface — Part Two 


Part Two of the Beginner's Guide to the Sun Workstation includes user’s guides to the Shells, 
the mail facility, the network news, a glossary and an annotated bibliography. The user’s guides 
provide details, examples and explanations of many of those commands and facilities presented in 
Part One. 

The Sun system supports two Shells, the C-Shell and the Bourne Shell. These Shells are more or 
less the same in ba.sic essentials, but they vary a lot in detail. To provide complete, basic 
descriptions of both Shells, the Shell user’s guides in Part Two contain some material that is 
similar and even repetitious. For specific information on the Shells, see the csh and sh pages in 
the Commands Reference Manual for the Sun Workstation. For detailed information on how to 
program the Shells, see the Programming Tools for the Sun Workstation. 

The chapters in Part Two are: 

1. Using the C-Shell — Introduces the C-Shell command interpreter and some commonly 
used Sun system commands. 

2. Using the Bourne Shell — Introduces the Version 7 UNIX Shell, the Bourne Shell. 

3. Mail User’s Guide — Provides details on the electronic mail facilities. 

4. Network News User’s Guide — Describes what the network news is, how to subscribe to 
newsgroups, how to read the news, and how to post your own news. 

5. Glossary — Provides brief definitions of terms and common commands. 

6. Bibliography — Provides an annotated list of Sun system and UNIX reference material. 

For additional details on any of the information presented in Part Two, refer to the Commands 
Reference Manual for the Sun Workstation and to the System Interface Manual for the Sun 
Workstation. 
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Chapter 1 


Using the C-Shell 


Using the C’-Skell^ introduces the basics of the C-Shell. It gives you a broad understanding of the 
shell’s operation, then provides more detailed information for learning to use the different C- 
Shell facilities. 


1.1. What is a Shell? 

A Shell is a program which provides you with interactive access to the operating systera via a 
combined command and programming language. A Shell’s primary purpose is to translate com¬ 
mand lines typed at the workstation into system actions, such as the invocation of other pro¬ 
grams. Because a Shell is a user program, just like any you might write, there is more than one 
available. The Shell you get when you log in is specified in your password file. 

Shell features include control-flow primitives, parameter passing, and variable and string substi¬ 
tution. The Shell supports constructs such as while, if~then~else, case, and /or. Two-way com¬ 
munication is possible between the Shell and commands. String-valued parameters, typically 
filenames or flags, may be passed to a command. Commands set a return code that may be used 
as Shell input. 

You can use the Shell to modify the environment in which commands run. You may redirect 
input and output to files, call processes that communicate through pipes, and define a directory 
searching sequence in the file system to call commands. Commands can be read either from the 
workstation or from a file, so command procedures can be stored in a file for later use. 

A Shell in the Sun operating system acts mostly as a medium through which other programs are 
invoked. While it has a set of built-in functions that it performs directly, most commands cause 
execution of programs that are external to the Shell. The Shell is thus distinguished from the 
command interpreters of other systems both by the fact that it is just a user program, and by 
the fact that it is used almost exclusively as a mechanism for invoking other programs. 

The Sun system supports two Shells, the C-Shell (csh) developed by William Joy at the Univer¬ 
sity of California at Berkeley and the Bourne Shell (sh) developed by S. R. Bourne at Bell 
Laboratories. After you log in to the Sun system, the C-Shell displays the prompt to indi¬ 
cate it is waiting for input. The Bourne Shell displays the ‘$’ prompt; this is an easy way to tell 
which Shell your system is running. The C-Shell permits its prompt to be modified and, in this 
guide, we show the prompt as ‘tutorial^’. 


^ The material in this chapter is derived from An Introduction to the C’Shcll, William N. Joy. 
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1.2. C-Shell Commands 

Commands in the Sun system consist of a list of strings or words. They are interpreted as a 
command name followed by arguments. Thus the command: 

tutorial% mail aam 

consists of two words. The first word mail names the command to be executed, in this case the 
mail program, which sends messages to other users. The C-Shell uses the name of the command 
in attempting to execute it for you. It looks in a number of directories for a file with the name 
maiV, which contains the mail program. 

The rest of the words of the command are given as arguments to the command itself when it is 
executed. In this case, the argument is sam, which is interpreted by the mail program to be the 
name of a user to whom mail is to be sent. You can use the mail command as follows: 

tutorial% mall flam 

Ifl the project meeting at 3:00? 

I may have another appointment. 

Joe 

"D 

EOT 

tutorial% 

Here Joe sent the user ‘sam’ a message and ended his message with a which sent an end-of- 
file to the mail program. The mail program then echoed the characters ‘EOT’ and transmitted 
Joe’s message. The C-Shell displays the ‘tutorial^ ’ prompt before and after the mail command 
to indicate that it is awaiting input. 

After displaying the ‘tutorial^’ prompt, the C-Shell reads command input from your workstar 
tion. When you type a complete command such as mail sam, the C-Shell executes the appropri¬ 
ate program, mail in this case, with an argument, sam. It then hands control over to the mfl»7 
program and waits for mail to complete. The mail program reads input from your workstation 
until you signal an end-of-file by typing a ^D. This causes mail to complete; the Shell notices 
that mail has completed and displays another ‘tutorial%’ prompt to signal you that it is ready to 
read another command from the workstation again. 

This is the essential pattern of all interaction with the Sun system through the C-Shell. You 
type a complete command that the C-Shell executes. When this execution completes, the C- 
Shell prompts for a new command. If you run the editor for an hour, the C-Shell waits patiently 
for you to finish editing and obediently prompts you again when you finish. 

An example of a useful command you can execute now is the tset command, which sets the erase 
and kill characters on your terminal — the erase character erases the last character you typed, 
and the kill character erases the entire line you have entered so far. By default, the erase char¬ 
acter is ‘DEL’ or ‘BACKTAB’, and the kill character is ‘"U’. You may prefer to use the back¬ 
space (*H) character as your erase character. You can make this change by using the tset com¬ 
mand with the —e option: 


® The notation *0 is read ‘control-D’ and means that you should hold down the CONTROL (or CTRL) 
key while pressing the D key. The shift key is ignored so that ‘‘'d’ and ‘ D’ are equivalent. 
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tutorial% tset —e 
Erase set to Ctrl—H 
Kill is Ctrl—U 
tutorial% 

This tells the program tsct to set the erase character to 


1.2.1, Specifying Optional Capabilities with Flag Arguments 

While many arguments to commands specify filenames or user names, some arguments called flag 
arguments specify an optional capability of a command that you wish to use. By convention, 
such flag arguments begin with the character ’ (hyphen). So, to produce a simple list of the 
files in the current working directory, use the la command: 

tutorial% Is 

bin dead.letter disk.usage mbox misc 

tutorial$ 

The flag option —s is the size option, which gives the size of each file in blocks of 512 characters; 
for example: 

tutorial% Is —8 
total 9 

1 bin 1 dead.letter 1 disk.usage 

5 mbox 1 misc 

tutorial% 

shows the number of 512-character blocks in each file. Refer to the Commands Reference 
Manual for available options for each command. Some commands like the la command have a 
large number of useful options, while other commands have either no options or only one or two. 


1.2.2. C-Shell Metacharacters 

The C-Shell has a number of special characters called metacharacters that have special func¬ 
tions. In general, most characters which are neither letters nor digits have special meaning to 
the C-Shell. There is a method of quoting that prevents the C-Shell from treating these meta^ 
characters in any special way. This notation is described in Quoting Away the Metacharacters. 

Metacharacters normally have effect only when the C-Shell is reading your input. You need not 
worry about placing C-Shell metacharacters in a letter you are sending with mail or when you 
are typing in text or data to some other program, for example. Note that the C-Shell is only 
reading input when it has prompted with ‘tutorial%’. See the C-Shell Metacharacters Summary 
for a complete list with meanings. 


1.2.3. Redirecting Output to Files with >' 

Commands that normally read input from or write output to the workstation can instead be exe¬ 
cuted using a file rather than the workstation for input and output. The date command nor¬ 
mally displays the current date on your workstation screen because your screen is the default 
standard output for the date command: 
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tutorial% date 

Thu Aug 4 10:58:37 PDT 1983 
tutorial% 

Suppose you wish to save the current date in a file called today. You can redirect the standard 
output of a command through a notation using the metacharacter to the today file rather 
than to the screen: 

tutorial% date > today 
tutorial% 

This command places the current date and time into the file today. Note that the date com¬ 
mand does not know that its output is going to a file rather than to the workstation. The C- 
Shell sets up this redirection before the command begins executing. 

One other thing to note here is that the C-Shell creates the file if it does not exist. The file 
today need not have existed before date was executed. And if the file does exist, its previous 
contents are discarded. You can set the C-Shell option noclobber to prevent this from happening 
accidentally; see the C-Shell Variables section on noclobber. 

The system normally keeps files that you create with permanently. If you wish to create a 
file which will be removed automatically you must have an entry in crontab. Begin the file’s 
name with a the ‘scratch’ character, to denote that the file will be a scratch file. The sys¬ 
tem removes such files after a couple of days, or sooner if file space becomes very tight. So if 
you don’t really want to save the output in the example above permanently, use the notation: 

tutorial% date > #today 
tutorial% 


1 . 2 . 4 . Redirecting Input from Files with ‘< ’ 

In the same way that you can redirect the standard output of a command to a file with ‘>’, you 
can also redirect the standard input of a command from a file with the ‘<’ character. This is not 
often necessary, however, since most commands read from a file whose name is given as an argu¬ 
ment. Redirection of input to the sort command looks like: 

tutorial% Bort < fruit 

apples 

bananas 

blueberries 

lemons 

limes 

nectarines 

oranges 

peaches 

pears 

plums 

strawberries 

tutorial% 

where the command reads its input from the file fruit. You would more likely let sort open the 
file fruit for input itself since this is less typing: 


1-4 


Revision A of 15 April 1985 



Beginner's Guide 


Using the C-Shell 


tutorial% sort fruit 

apples 
bananas 
< etc. > 
plums 

strawberries 

tutorial% 

Note that if you just type fort and do not redirect the standard input, as in: 
tutorial% sort 

the sort program sorts lines from its standard input, the workstation, taking what you type as 
data, until you type a "D to indicate an end-of-file. The default standard input for programs 
comes from the workstation keyboard. 


1,2.5. Chaining Commands in a Pipeline 

In the C-Shell, you can connect the standard output of one command to the standard input of 
another; that is, you can run the commands in a sequence known as a pipeline. For instance, the 
Is command with the —s option normally produces a list of the files in your directory with the 
size of each in 512-character blocks: 

tutorial% Is —a 
total 388 

1 Makefile 286 doc.tbl 40 gloss 

56 mail.all 5 refs.all 

tutorial% 

If you are interested in learning which of your files is largest, you want to sort the list by size. 
You can look at the many Is options to see if there is an option to do this, but you would eventu¬ 
ally discover that there is not. 

Instead you can use a couple of simple sort options and combine them with Is with the ‘|’ nota¬ 
tion to invoke the pipe mechanism to get what you want. Thus, you can pipe Is to sort by typ¬ 
ing: 

tutorial% la —a | aort —n 
total 388 
1 Makefile 
5 refs.all 
40 gloss 
56 mail.all 
286 doc.tbl 
tutorial% 

This runs the Is command with the option —s and pipes this Is output to the sort command with 
the numeric option —n. Your list of files is sorted by size with the smallest first. You can then 
use the —r reverse sort option and the head command in conjunction with the previous com¬ 
mand: 
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tutorial% 1» -8 j sort —n —r ] head —3 

286 doc.tbl 

56 mail.all 

40 gloss 

tutorial% 

Here you take a list of your files sorted alphabetically, each with the size in blocks. You pipe 
this to the standard input of sort asking it to sort numerically in reverse order, that is,^ largest 
first. This output is then piped into the head command, which shows you the first few lines. In 
this case you ask head for the first three lines. Thus this pipeline gives you the names and sizes 
of your three largest files. 

The C-Shell connects commands separated by ‘1’ characters, and the standard output of each is 
run into the standard input of the next. The leftmost command in a pipeline normally takes its 
standard input from the workstation keyboard, and the rightmost normally sends its standard 
output to the workstation screen. Other examples of pipelines are provided later in the descrip¬ 
tion of foreground and background jobs. 


1.2.6, Pathnames and Filenames 

Sun system pathnames consist of a number of components separated by a slash 7’- Each com¬ 
ponent, except the last, names a directory in which the next component resides, in effect specify¬ 
ing the path of directories to follow to gain access to the file. Thus the pathname: 

/etc/motd 

specifies a file in the directory /etc, which is a subdirectory of the root directory ^/\ Within this 
directory the file named is motd, the ‘message of the day’ file. A pathname that begins with a 
slash is said to be an absolute pathname since it specifies a complete path from the absolute top 
of the directory hierarchy of the system, the root Pathnames which do not begin with ‘/’ are 
interpreted as starting in the current working directory, which is by default, your home directory 
and which you can change dynamically with the ed (change directory) command. Such path¬ 
names are said to be relative to the working directory since they are found by starting in the 
working directory and descending to lower levels of directories for each component of the path¬ 
name. If the pathname does not contain any slashes at all, the file is contained in the working 
directory itself, and the pathname is merely the name of the file in this directory. Absolute 
pathnames have no relation to the working directory. 

Most filenames consist of a number of alphanumeric characters and ‘.’s (dots). In fact, filenames 
can have all printing characters except ‘/’. Remember that it is inconvenient to have most non- 
alphabetic characters in filenames because many of these characters are metacharacters that 
have special meaning to the C-Shell. The character (dot) is not a C-Shell metacharacter and 
often separates the extension of a filename from the base of the name. Consider the following 
four related files: 

data.c data.o data.errs data.output 

The files share a base portion, ‘data’, of a name and have different extensions, ‘c , ‘o , errs , and 
‘output’. The file data.c might be the source for a C program, the file data.o the corresponding 
object file, the file data.errs the errors resulting from a compilation of the program, and the file 
data.output the output of a run of the program. 
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L2,l. Filename Expansion — T }’ 

Consider again the following four related files: data.c, data.o, data.output, and data.errs. If you 
want to refer to all four of these files in a command, use the notation, which the C-Shell 
expands to match any sequence, including the empty sequence, of characters in a filename. For 
example, if you use: 

data.* 

the C-Shell expands this word into a list of names which begin with ‘data’ before executing the 
command to which it is an argument. The names that match data.* are alphabetically sorted 
and placed in the argument list of the command. Thus the echo command and this notation 
display the four related files as; 

tutorial% echo data.* 

data.c data.errs data.o data.output 

tutorial% 

Note that the names are in sorted order here and a different order than you listed them above. 
The echo command receives four words as arguments, even though you only directly type one 
word as an argument. Filename expansion of the one input word, data. * generates the four 
words. 

As matches any sequence of characters in a filename, the character matches any single 
character in a filename. So, to echo a line of filenames, type: 

tutorial% echo ? ?T TTT 

This echoes first those with one-character names, then those with two-character names, and 
finally those with three- character names. The names of each length are independently sorted. 

Another mechanism matches any single character from a sequence of characters between ‘[ ]’. 
So to match; 

data.c data.o 

in the example above, use: 

tutor!a 1% echo data.[co] 
data.c data.o 
tutorial% 

You can also place two characters around a in the ‘[ ]’ notation to denote a range. Thus to 
match: 


chap.1 chap.2 chap.3 chap.4 chap.5 

if they exist, use: 

tutorial% echo chap.[l—5] 

chap.l chap.2 chap.3 chap.4 chap.5 

tutorial% 

‘This is shorthand for 

chap.[12345] 

and otherwise equivalent. 

Note that if a list of arguments to a command, that is, an argument list, contains filename 
expansion syntax that fails to match any existing filenames, the C-Shell considers this to be an 
error and displays the diagnostic: 
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No match. 

and does not execute the command. 

Another important point is that files with the character (dot) at the beginning of their names 
are specially treated. Neither 7’ nor the *[ )’ mechanism matches it. This special treatment 
prevents accidental matching of the filenames 7’ and in the working directory; these files 
have special meaning to the system. 

Another filename expansion mechanism gives access to the pathname of the home directory of 
other users. This notation consists of the character (tilde) followed by another user’s login 
name. For instance, ~«om maps to the pathname /usr/sam if the home directory for ‘sam’ is 
jusrlsam. Use this notation when you need to gain access to other users’ files in directories with 
different prefix directory names. It’s an easier and more reliable method than typing out the 
entire pathname, 

A special case of this notation consists of a alone, such as ''/mhox. The C-Shell expands this 
notation into the file mbox in your home directory, that is, into Intrjtamlmhox for your fellow 
user Sam. This is very useful if Sam uses cd to change to another directory and finds a file he 
wants to copy to his home directory using cp. The C-Shell expands into lusr/aam, Sam’s 
home directory, and copies the file thatstuff there if ‘sam’ types: 

tutorial% cd programs 
tutorial% pwd 
/usr/sam/programs 
tutorial% cp thatstuff * 
tutorial% cd 
tutorial% Is 
thatstuff 
tutorial% 

Another form of filename expansion uses the characters }’. Braces specify that the contained 
strings, separated by a comma ( , ) are to be consecutively substituted into the containing char¬ 
acters and the results expanded left to right. So, you can abbreviate a set of words that have 
common parts but cannot be abbreviated by the above mechanisms because they are not files, or 
because they are the names of files which do not yet exist. Thus: 

A>(strl, str2, . . .strn>B 

expands to: 

AstrlB Astr2B ... AstrnB 

The contained strings ‘strl,str2...strn’ are consecutively substituted into the containing charac¬ 
ters ‘A’ and ‘B’ and expanded left to right. This expansion occurs before the other filename 
expansions, and may be applied recursively, that is, nested. The results of each expanded string 
are sorted separately, left to right order being preserved. If the resulting filenames don’t exist, 
they are created if you don’t use other expansion mechanisms. You can use this mechanism to 
generate arguments which are not filenames, but which have common parts. A typical use below 
makes subdirectories doa, memos and letters in your home directory: 

t:utorial% mkdlr "'/{docB,memos,letters} 

tutorial% Is 

docs letters memos 

tutorial% 

This mechanism is most useful when the common prefix is longer than in this example, for 
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instance, to list all the directories below without typing each individually, use the }’ mechan¬ 
ism: 

tutorial% 1 b /usr/ucb/ {pi, whereis} 

/usr/ucb/pi 

/usr/ucb/whereis 

tutorial% 

See the C-Shell Metacharacters Summary for a quick reference list of these characters. 

1.2.8. Quoting Away the Metacharacters 

Because the C-Shell uses these metacharacters for special purposes, you cannot use them directly 
as parts of words. If you try to use the echo command and as its argument, it doesn’t work 
properly because of the special significance of Thus the echo command does not show the 
character 

tutorial% echo * 

It either echos a sorted list of filenames in the current working directory, or displays the message 
‘No match.’ if there are no files in the working directory. 

To place characters that are neither numbers, digits, ‘.’ nor in an argument word to a 
command, enclose them with single quotation characters For example, to quote away the 
special meaning of type: 

tutorial% echo 
* 

tutorial% 

Here the echo command displays the character, and ignores any special meaning. 

There is one special character M’ that the history mechanism uses and that you cannot escape by 
placing within ’ characters. Precede ‘I’ and the character ’ itself by a single ‘ \’ to prevent 
their special meanings. So to echo ‘ ’!’, use: 

tutorial% echo \' \! 

'! 

tutorial% 

With these two mechanisms, you can place any printing character into a word which is an argu¬ 
ment to a C-Shell command. You can combine the two mechanisms, as in: 

tutorial% echo\"*' 
tutorial% 

The first \ escapes the first ’, and the was enclosed between ’ characters, so neither 
retains its special meaning to the C-Shell. 


1.2.9. How to Terminate C-Shell Commands 

When the C-Shell is waiting for an executing command to complete, there are several ways to 
stop that command. For instance, if you list all system users with the cat command: 
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tutorial% cat /ctc/pasewd 

bugs:nologin:7:10:bug reporting:/usr/bugs:/dev/nul1 
prot:ZSMXceOkDv9hw:11:10:Vic Prot:/usr/prot:/bin/csh 

< etc. > 

sam:Iu2nX.wzcjYBo:953:10:Sam Brown:/usr/sam:/bin/csh 
rjb:9rYbUmD9JrJvw:954:20:Robert Baker:/usr/rjb:/bin/csh 
tutorial% 

this list is likely to continue scrolling off your screen for several seconds unless you stop it. You 
can send an INTERRUPT signal to the cat command by typing X (or the.DEL or RUBOUT key 
if that’s the way your keyboard is set up). Since the cat command does not take any precautions 
to avoid or otherwise handle this signal, the terminates cat. The C-Shell notices that cat has 
terminated and prompts you again with ^tutorial%’. If you type a C again, the Shell just 
repeats its prompt since it ignores INTERRUPT signals and continues executing commands 
rather than terminating like cat did. Terminating at this point would otherwise have the effect 
of logging you out. 

Many programs terminate when they get an end-of-file from their standard input. Thus, you ter¬ 
minated this mail program in the first example above by typing a D, which generates an end- 
of-file from the standard input. The C-Shell also terminates when it gets an end-of-file and 
displays ‘logout’; the Sun operating system then logs you off the system. Since this means that 
typing too many 'D’s can accidentally log you off, the C-Shell provides a mechanism to prevent 
this. See the ignoreeof description in the C-Shell Variables section. 

If you redirect a command’s standard input from a file, the command normally terminates when 
it reaches the end of that file. So if you redirect input to the mail command with: 

tutorial% mail sam < doc,text 
tutorial% 

mail terminates without your typing a because it reads to the end-of-file of your file doc.text. 
You can also use the pipe mechanism to pipe the standard output of the cat command to the 
mail command: 

tutorial% cat doc.text ] mail sam 
tutorial% 

The cat command then writes the text through the pipe to the standard input of the mad com¬ 
mand. When cat completes, it terminates, closing down the pipeline, and the mail command 
receives an end-of-file from it and terminates also. Using a pipe here is more complicated than 
redirecting input, so use the first form. Typing ^C also stops both of these commands. 

Another way to stop a command is to suspend its execution temporarily, with the possibility of 
continuing execution later. Do this by sending a STOP signal with Z. This signal suspends all 
running commands, but there may be more than one if a pipeline is executing. The C-Shell 
notices that the command(s) have been suspended, displays ‘Stopped’ and then prompts for a 
new command. The previously executing command has been suspended, but is otherwise 
unaffected by the STOP signal. Any other commands can be executed while the original com¬ 
mand remains suspended. You can then continue the suspended command using the fg (fore¬ 
ground) command without any arguments. The C-Shell redisplays the command to remind you 
which command is being continued, and resumes the command execution. The suspension has no 
effect whatsoever on the execution of the command unless the input files that the suspended 
command is using have been changed in the meantime. Suspending commands can be very use¬ 
ful during editing, when you need to look at another file before continuing. An example of com¬ 
mand suspension follows: 
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tutorial% mail peter 

You can copy the source from the directory named 
"Z 

Stopped 
tutorial% Is 
data.c 
data.o 
muchstuff 
tutorial% jobs 
[1] + Stopped Mail peter 

tutorial% fg 
Mail peter 
(continue) 

data.c. Let*B discuss the project later* 

“D 

EOT 

tutorial% 

In this example you send a message to Peter but forget the name of the file you want to mention. 
You stop the mail command by typing "Z. When the C-Shell notices that mail 'is suspended, it 
displays ‘Stopped’ and prompts for a new command. You then use the h command to find out 
the name of the file. You then type the jobs command to see which command was suspended, 
mail peter in this case. You type the fg command to continue mail execution. Input to the mai7 
program is then continued and ended with a "D which indicates the end of the message. Mail 
displays EOT for end-of-transmission. 

Type "Z only at the beginning of a line since everything typed on that current line is discarded 
when a signal is sent from the keyboard. This also happens with the "C (INTERRUPT) and 
(QUIT) signals. See the section on Running Jobs for more information on suspending and con¬ 
trolling jobs. 

If you write or run programs which are not fully debugged, it may be necessary to stop them 
somewhat ungracefully. Send them a QUIT signal by typing a "\. This usually provokes the C- 
Shell to produce a message like: 

Quit (Core dumped) 

indicating that a file core has been created containing information about the program’s state 
when it was terminated by the QUIT signal. You can examine this core file yourself using a 
debugger, or forward information to the maintainer of the program telling him where the core 
file is. 

When you run background commands, they ignore INTERRUPT and QUIT signals at the works¬ 
tation. To stop the background commands, you must use the kill command. See the Running 
Jobs section for an explanation and examples. 

If you want to examine the output of a command without having it zip off the screen as the out¬ 
put of the cat command below does: 

tutorial^ cat /etc/passwd 

use the more paging command to display it a page at a time: 

tutorial% more /etc/passwd 

The more program pauses after each complete screenful and displays ‘—More—’ at which 
point you can type a space to get another screenful, press RETURN to get another line, or type 
a ‘q’ to end more. You can also use more as a filter through which to pipe the cat command: 
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tutorial% cat /etc/pa»«wd | more 

This works just like the simple more command above. 

For stopping output of commands not involving more, use the S key to stop the typeout. The 
typeout resumes when you type "Q. Typing "S and "Q works well on low-speed terminals, but 
use more if you find it hard to type "S and "Q fast enough to paginate the output nicely. 

You can also use the "O flush output character. Typing "0 quickly throws away or ‘flushes’ all 
output from the current command until the next input read occurs or until the next Shell 
prompt. Use "O to complete a command’s execution without your having to suffer through the 
output on a slow terminal. Typing toggles output flushing on and off. 

1.2.10. Changing Shells 

If you are running the C-Shell, log in normally and follow the examples provided in the C-Shell 
Details section. 

If you are not running the C-Shell when you log in, you are using the Bourne Shell, /bin/sh or 
sh. In fact, much of the above discussion is applicable to /bin/sh, as is noted in Using the 
Bourne Shell in Part Two. 

If you are not using the C-Shell now, log in and change to the C-Shell with the csk command: 

$ esh 
tutorial% 

To change back to the Bourne Shell, use the eh command: 

tutorial% sb 
$ 


1,3. C-Shell Details 

This section describes more advanced features and details of the C-Shell. 


l.S.l. Starting and Terminating the C-Shell 

When you log in, the system starts the C-Shell running in your home directory. The C-Shell 
begins by reading commands from the .eshre file in this directory. All Shells which you may 
start during your workstation session read from this file. You can put specific commands there 
that are described later. For now, however, you do not need this file, and the C-Shell does not 
complain about its absence. 

This first C-Shell is called the login Shell. This login Shell reads commands from .cehre, after 
which it reads commands from a file called .login, also in your home directory. This .login file 
contains commands which you wish to execute once each time you log in to the system. A .login 
file looks something like: 
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set ignoreeof 

setenv EXINIT *set noai wrapmargin=8' 
set path=(. /usr/ucb /bin /usr/bin) 
set mail=(/usr/spool/mail/sam) 

The first is a set command, which the C-Shell interprets directly. Set turns on the C-Shell vari¬ 
able ignoreeof, which prevents the C-Shell from logging you out if you type '‘D. Rather, you use 
the logout command to log off the system. 

The setenv command sets the value of an environment variable, in this case to use the editors ex 
and vi without automatic cursor indentation {set noat) and with an automatic cursor return or 
‘wrap’ to the left side of the screen eight columns from the right screen edge {wrapmargin=8). 

The path variable defines the search path through which the C-Shell looks for files and programs. 
The mail variable sets the location of the user Sam’s system mailbox. When the mail program 
finishes checking for your mail, the C-Shell finishes processing your .login file and begins reading 
commands from the workstation, prompting for each with ‘tutorial^’. When you log off with 
*D, the C-Shell displays ‘logout’ and executes commands from the file .logout if it exists in your 
home directory. After that the C-Shell terminates, and you are logged off the system. You then 
receive a new login message. In any case, after you type logout, the C-Shell is committed to 
terminating and will take no further input from your keyboard. 


l.S.2. C-Shell Variables 

The C-Shell maintains a set of variables. Each C-Shell variable has an array of zero or more 
strings as its value. Use the set command to assign values to C-Shell variables. Set has several 
forms, the most useful of which was already given above in the .login example as: 

set name-value 

C-Shell variables may store values which are used in commands later through a substitution 
mechanism. However, the most commonly used C-Shell variables are those which the C-Shell 
itself refers to. By changing the values of these variables called variables, you can 

directly affect the C-Shell’s behavior. 

One of the most important variables is path, which contains a sequence of directory names where 
the C-Shell searches for commands. The set command without an argument shows the value of 
all variables currently defined or ‘set’ in the C-Shell, You can see what the default value for 
path is by typing the set command: 
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tutorial% set 

argv 

0 

cwd 

/usr/sam 

history 30 

home 

/usr/sam 

mail 

(/usr/spool/mal1/sam) 

path 

(. /usr/ucb /bin /usr/bin) 

pron^jt 

tutorial% 

shell 

/bin/esh 

status 

0 

term 

sun 

user 

sam 

tutorial% 


This output indicates that the variable path points to the current directory, symbolized by 
(dot) and then I\t9rlucb, /bin and lusribin. Commands developed at the University of Califor¬ 
nia at Berkeley live in /mr/xicb, while commands developed at Bell Laboratories live in /6m and 
/tisr/bin. A number of commands developed at Sun, particularly commands that used to live in 
/asr/ixintool, now live in /utr/hin also. 

A number of locally developed programs on the system live in the directory /utr/local If you 
want all Shells which you invoke to have access to these new programs, place the command: 

set path=(. /usr/local /usr/ucb /usr/bin /bin) 

in your file .login in your home directory. Try doing this, and then log out and back in. Now 
type the set command again to see that the value assigned to path has changed; 

tutorial% set 

argv () 

cwd /usr/sam 

< etc.> 

path (. /usr/ucb /bin /usr/bin /usr/local) 

< etc. > 

user sam 

tutorial% 

Be aware that the C-Shell initially examines each directory in your path and determines which 
commands are contained there. Except for the current directory which the C-Shell treats 
specially, this means that if commands are added to a directory in your search path after you 
have started the C-Shell, the C-Shell will not necessarily find them. If you wish to use a com¬ 
mand which has been added in this way, use the rehash command to recompute the C-Shell’s 
internal hash table of command locations so that it finds the newly added command: 

tutorial% rehash 
tutorial% 

If you do not run rehash, the hashing algorithm may tell the C-Shell that the command wasn’t in 
that directory when the hash table was computed. Since the C-Shell has to look in the current 
directory on each command, it can always find commands in the current working directory. 

Other useful built-in variables are the variable home, which shows your home directory, cwd, 
which contains your current working directory, and the variable ignoreeof, which can be set in 
your .login file to tell the C-Shell not to exit when it receives an end-of-file from your keyboard. 
The variable ignoreeof is one of several variables that only have the value set or unset. Thus, to 
set this variable you simply type the following in your .login file; 
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set Ignoreeof 

If you type the character "D accidentally, you get the message ‘Use **exit to leave csh”’. Then 
use the logout command to terminate the login Shell. 

To unset the ignoreeof option temporarily for that login session, type: 

tutor!a 1% unset ignoreeof 
tutorial% 

These actions do not give the ignoreeof variable a value, but none is desired or required. 

Another useful built-in C-Shell variable is the noctobber variable. If you use the metasyntax: 

> filename 

to redirect the standard output of a command, you normally overwrite and destroy the previous 
contents (if any) of the named file, here filename. Because of this, you may accidentally 
overwrite a valuable file. If you want to prevent the C-Shell from overwriting files in this way, 
add the noclobber variable to your .login file: 

set noclobber 

Then try to redirect date into the today file: 

tutorial% date > today 
today: File exists. 
tutorial% 

Noclobber warns you if today already exists. If you really want to overwrite the contents of 
today, you can use the M’ character to force the action: 

tutorial% date >! today 
tutorial% 

The ‘>!’ is a special metasyntax indicating that clobbering the file is allowed. The space 
between the and the filename today is critical here, as ‘Itoday’ would be an invocation of the 
Aiafory mechanism, and have a totally different effect. 

See ceh in the Commands Reference Manual lox variables. 


1.3.3. The History Mechanism 

The C-Shell can maintain a history list into which it places the words of previous commands. 
You can reuse these commands or words from them to form new commands. You can also use 
history to repeat previous commands or to correct minor typing mistakes. 

To use the history mechanism, edit your .eshre file to contain: 

set history=30 
Then type: 

tutorial% source .eshre 
tutorial% 

to have the change take effect. Then after you have typed several commands, you see that typ¬ 
ing just history shows the contents of the history list: 
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tutorial% history 

1 Is 

2 mkdir misc 

4 cd misc 

5 vi tut.memo 

6 spell tut.memo > mem.sp & 

7 pwd 

8 cd supplements/tutorial 

9 history > hist.list 
tutorial% 

You can use the numbers given with the history events to refer to previous events, which are 
difficult to refer to using the contextual mechanisms introduced above. For example, to reuse 
command number 8, type simply: 

tutorial% !8 
cd supplements/tutorial 
tutorial% pwd 

/usr/sam/supplements/tutorial 

tutorial% 

The figure on the following page gives a sample session involving typical history mechanism com¬ 
mands. 
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tutorial% cat bug.c 
main () 

{ 

printf(”hello) ; 

} 

tutorial% cc !$ 
cc bug.c 

"bug.c”, line 4: newline in string or char constant 
"bug.c", line 5: syntax error 
tutorial% ed !$ 
ed bug.c 

29 

4s/) ;/"Vp 

printf("hello"); 
w 

30 

q 

tutorial% !c 
cc bug.c 
tutorial% a.out 
hellotutorial% te 
ed bug.c 
30 

4s/lo/lo\\n/p 

printf("hello\n"); 
w 
32 

q 

tutorial% !c -o bug 

cc bug.c —o bug 

tutorial% size a.out bug 

a.out: 2784+364+1028 = 4176b = 0x1050b 

bug: 2784+364+1028 = 4176b = 0x1050b 

tutorial% U —1 !* 

Is —1 a.out bug 

-rwxr-xr*x 1 bill 3932 Doc 19 09:41 a.out 

-rwxr~xr-x 1 bill 3932 Dec 19 09:42 bug 

tutorial% bug 
hello 

tutorial% at -n bug.c | spp 
spp: Command not found. 
tutorial% grep<v *^[sptab]*[0.9]*[sptab]*$* 
at -n bug.c | ssp 
1 main() 

3 { 

4 printf("hello\n"); 

5 > 

tutorial% !! | Ipr 

at -n bug.c | ssp j Ipr 

tutorial% 


Figure 1-1: Sample history Use 
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In this example you have a very simple C program, with a bug (or two) in the file bug.c, which 
you cat out on your workstation. You then try to run the C compiler on it, referring to the file 
again as meaning the last argument to the previous command. Here the is the history 
mechanism invocation metacharacter, and the stands for the last argument, by analogy to ‘$’ 
in the editor, which stands for the end of the line. The C-Shell echoes the command, as it would 
have been typed without use of the history mechanism, and then executes it. The compilation 
yields error diagnostics, so you now run the editor on the file you are trying to compile, fix the 
bug, and run the C compiler again. This time you refer to this command simply as ‘!c’. This 
repeats the last command which started with the letter ‘c’. If you have used other commands 
starting with ‘c’ recently, you have to say ‘!cc’. Typing Mcc:p’ prints the last command starting 
with ‘cc’ without executing it, so you can check which previous command you want. 

After this recompilation, you run the resulting a,out file, and then note that there still is a bug, 
and run the editor again. After fixing the program you run the C compiler again, but tack onto 
the command an extra o bug’ telling the compiler to place the resultant binary in the file 6«^ 
rather than a.out. In general, you can use the history mechanism anywhere in the formation of 
new commands, and you can place other characters before and after the substituted commands. 

You then run the size command to see how large the binary program images you have created 
are, and then an Is —I command with the same argument list, denoting the argument list 
Finally, you run the program bug to see that its output is indeed correct. 

To make a numbered listing of the program, you run the at -n command on the file bug.c. To 
remove blank lines in at -n output, you run the output through the following command sequence: 

grep -v '“ [sptab] * [0.9] * [sptab]*$’ 

Note that the symbols ‘f and are the same thing. This is similar to the substitute command 
in the editor. Finally, you repeat the same command with M!’, but send its output to the line 
printer. 

There are other mechanisms available for repeating commands. History displays a number of 
previous commands with numbers by which they can be referenced. There is a way to refer to a 
previous command by searching for a string which appeared in it, and there are other, ways to 
select arguments to include in a new command. Refer to the C-Shel! pages in the Commands 
Reference Manual for a complete description. 


l.S.4‘ The Alias Mechanism 

The alias mechanism substitutes one string for another before the C-Shell executes it. Use the 
C-Shell’s alias mechanism to supply default arguments to commands, or to perform transforma¬ 
tions on commands and their arguments. The alias facility is similar to a macro facility. Some 
of the features obtained by aliasing can also be obtained using C-Shell command files, but these 
take place in another instance of the Shell and cannot directly affect the current Shell’s environ¬ 
ment or involve commands such as cd, which must be done in the current Shell. 

As an example, suppose that there is a new version of the mail program called newmail on the 
system. You would rather use it than the standard mail program, which is called mail. If you 
place the C-Sheli command: 

alias mail newmail 

in your .cshrc file, the C-Shell transforms an input line of the form 


M8 
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tutorlal% mall sam 

into a call on newmail Suppose you want the command h to always show which list entries are 
subdirectories, which are files, and which are symbolic links to other directories, that is to always 
use a —F option. Put the following alias in your .ctkrc file: 

alias Is Is —F 

If you then type U, you actually use la —F: 
tutorial% U 

bin/ lint.mss mbox misc/ supplements/ 

You can also use: 

alias If Is —F 

to create a new command syntax If that calls la -F. So, using this alias on the home directory of 
‘sam’, you get: 

tutorial^ If "sam 

bin/ dead.letter mbox misc/ supplements/ 
tutorial% 

or a list of files and directories in /«ar/«am with the — F indications of for a directory. 

Thus the aliaa mechanism creates short names for commands, provides default arguments, and 
defines new short commands in terms of other commands. You can also define aliases which con¬ 
tain multiple commands or pipelines, showing where the arguments to the original command are 
to be substituted using the facilities of the kiatory mechanism. To call an la command after each 
cd (change directory) command, use the alias: 

alias cd 'cd \f* ; Is ' 

Enclose the entire alias definition in ’ characters to prevent most filename expansions from 
occurring and the character from being recognized as a metacharacter. The here is escaped 
with a ‘\’ to make it apply to the argument list of the aliased cd command itself rather than 
searching the history list for a previous command. The ‘\!*’ here substitutes the entire argu¬ 
ment list to the pre-aliasing cd command without giving an error if there aren’t any arguments. 
The V separating commands indicates that one command is to be done and then the next. 
Remember to run the aource command on your .cahrc file to have any changes you make take 
effect: 


tutorial% source .cshrc 
tutorial% 

When you use this aliaa, it looks like: 


tutorial% cd /uar/games 
abuse bed 

adventure boggle 

arithmetic 

tutorial^ 


cribbage 

fish monop 

< etc. > 


mille scifi 
snake wun^ 


worms 


This cd command not only changes directories, here to fuarigamea, but it also lists all the games 
available. 


Similarly to define a command which looks up its first argument in the password file, put in your 
,cahrc file: 
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alias whois 'grep \!“ /etc/passwd' 

Then, when you type whois plus a username, the C-Sheil calls grep to look in the letcfpasswd 
file: 

tutorial% whois allce 

alice:IBkUBlXESfxGy:55:20:Alice Smith:/usr/alice:/bin/csh 
tutorial% 

Use the unalias command at the ‘tutorial^’ prompt to remove aliases temporarily for that Shell 
session. 

Warning: the C-Sheli currently reads the .cshrc file each time it starts up, so if you place a large 
number of commands there, the C-Shell will tend to start slowly. Try to limit the number of 
aliases to 10 or 15. 


1,S.5, The Redirection Notation and ">&' 

In addition to the standard output, commands also have a diagnostic output, which is normally 
directed to the workstation screen even when the standard output is redirected to a file or a 
pipe. You occasionally may want to direct the diagnostic output along with the standard output. 
For instance, if you want to redirect the output of a long running command into a file and wish 
to have a record of any error diagnostic it produces, you can type; 

tutorial% command >& file 
tutorial^ 

The here tells the C-Shell to route both the diagnostic output and the standard output into 
file. Use the command form command >&! file if noclobber is set and file already exists to 
overwrite file. 

Similarly you can route both standard and diagnostic output through the pipe to the line printer 
Ipr by typing: 

tutorial% command\&\pT 
tutorial% 

Finally, to place standard output at the end of an existing file, type: 

tutorial% command » file 
tutorial^ 

If noclobber is set, an error message ‘file: No such file or directory.’ results if file for example, 
does not exist; otherwise the C-Shell creates the named file. The form command »! file elim¬ 
inates the error condition if file does not exist when noclobber is set. 


1.3.6, Running Jobs in the Background^ Foreground, or Suspended 

When one or more commands are typed together as a pipeline or as a sequence of commands 
separated by semicolons, the C-Shell creates a single job consisting of these commands together 
as a unit. Single commands without pipes or semicolons create the simplest jobs. Usually, every 
line typed to the C-Shell creates a job. Some lines that create jobs (one per line) are 
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tutorla1% sort < data 
tutorial^ Is —s | sort —n | head —5 
tutorial^ mall harold 

The job is started as a background job if you type the metacharacter at the end of the com¬ 
mands. This means that the C-Sheli does not wait for the command to complete but immedi¬ 
ately prompts for another. The job runs m the background at the same time that the C-Shell 
continues to read and execute normal jobs, called foreground jobs. Thus, to redirect the output 
of the du program to a file called diskMsage, for instance, type: 

tutorial% du > disk.usage & 

[1] 503 
tutorial% 

Du reports on the disk usage of your working directory, as well as any directories below it. This 
command sequence puts the output into the file disk.usage, and the Shell returns immediately 
with a prompt for the next command without waiting for du to finish. The du program continues 
executing in the background until it finishes, even though you can type and execute more com¬ 
mands in the meantime. When a background job terminates, the C-Shell displays a message just 
before the next prompt telling you that the job has completed. In the following example, the du 
job finishes sometime during the execution of the mail command and its completion is reported 
just before the prompt after the maiVjob is finished. 

tutorial% du > disk.usage & 

[1] 503 

tutorlal% mail sam 

How do you know when a background Job is finished? 

"D 

EOT 

[1] — Done du > disk.usage 

tutorial% 

If the job did not terminate normally, the ‘Done’ message might say something else like 
‘Stopped.’ If you want the terminations of background jobs to be reported at the time they 
occur, which may interrupt the output of other foreground jobs, you can set the notify variable 
in your .cshrc file. In the previous example this would mean that the ‘Done’ message might have 
come right in the middle of the message to Sam. The STOP, INTERRUPT, or QUIT signals 
mentioned earlier, when typed on the keyboard, do not affect background jobs. 

Until they terminate, jobs are recorded in a table inside the C-Shell. The C-Shell remembers the 
command names, arguments and the process numbers of all commands in the job in this table as 
well as the working directory where the job was started. Each job in the table is either running 
in the foreground with the C-Shell waiting for it to terminate, running in the background, or 
suspended. Only one job can be running in the foreground at one time, but several jobs can be 
suspended or running in the background at once. As each job is started, it is assigned a small 
identifying number called the job number which you can use later to refer to the job in the com¬ 
mands described below. Job numbers remain the same until the job terminates and then are re¬ 
used. 

Before prompting you for another command, the C-Shell displays the background job’s number, 
as well as the process numbers of all its top-level commands. For example, if you run the follow¬ 
ing command in the background by typing the ampersand character at the end: 
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tutorial% Is -8 I sort -n > flle.llst & 

[2] 2034 2035 
tutorial% 

the h program runs with the -s option, pipes this output to the sort program with the -n 
option, which puts its output into the file filcMst. The at the end of the line starts these two 
programs together as a background job. After starting the job, the C-Shell displays the job 
number in brackets, 2 in this case, followed by the process number of each program started in 
the job. Then the C-Shel! immediately prompts for a new command, leaving the job running 
simultaneously. 

As mentioned in the How to Terminate C-Shell Commands section, typing "Z suspends currently 
running foreground jobs. You can suspend a background job by using the stop command 
described below. When jobs are suspended, they merely stop any further progress until started 
again, either in the foreground or the background. The C-Shell notices when a job becomes 
stopped and reports this fact, much like it reports the termination of background jobs. Stopping 
a foreground job looks like: 

tutorial% du > disk.usage 
"Z 

Stopped 

tutorial% 

The C-Shell displays the ‘Stopped’ message when it notices that the du program stopped. For 
background jobs, using the stop command, it is: 

tutor ial% sort disk.usage & 

[1] 2345 

tutorial% stop %1 

[1] + Stopped (signal) sort disk.usage 
tutorial% 

The ‘(signal)’ indicates that the job has been stopped by an indirect signal, as opposed to being 
stopped by "Z. Suspending background jobs can be very useful when you need to temporarily 
change what you are doing, that is, execute other commands, and then return to the suspended 
job. Also, you can suspend foreground jobs and then continue them as background jobs using 
the bff command. Thus, you can continue other work and stop waiting for the foreground job to 
finish. For example: 

tutorial% du > disk.usage 
"Z 

Stopped 

tutorial% bg 

[1] du > disk.usage & 

tutorial% 

starts du in the foreground, stops it before it finishes, then continues it in the background so you 
can execute more foreground commands. The bg command runs a suspended job in the back¬ 
ground. It is usually used after stopping the currently running foreground job with the "Z STOP 
signal. The combination of the STOP signal and the bg command changes a foreground job into 
a background job. This is especially helpful when a foreground job ends up taking longer than 
you expected, and you wish you had started it in the background in the beginning. 

All job control commands can take an argument that identifies a particular job. Begin all job 
name arguments with the character since some of the job control commands also accept 
process numbers, as displayed by the ps command. If you do not specify a job, a job control 
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command uses the default job, that is, the current job. This current job is identified by a ‘-f ’ in 
the output of the jobs command, which shows which jobs you have. When only one job is 
stopped or running in the background as is the usual case, it is always the current job, so no 
argument is needed. If a job is stopped while running in the foreground, it becomes the current 
job and the existing current job becomes the previous job, identified by a ’ in the jobs output. 
When the current job terminates, the previous job becomes the current job. When given, the 
argument is either ^%-\ which indicates the previous job, where is the job number, 

‘%pref’ where pref is some unique prefix of the command name and arguments of one of the 
jobs, or followed by some string found in only one of the jobs. 

The jobs command displays the table of jobs, giving the job number, status (‘Stopped’ or ‘Run¬ 
ning’) and command name for each background or suspended job: 

tutor la 1% du > dlsk.usage & 

[1] 3398 

tutorial% la —a ] aort — n > myflle & 

[2] 3405 

tutorial% mail bill 

Stopped 
tutorial% joba 

[1] - Running du > disk.usage 

[2] Running Is —s | sort —n > myfilo 

[3] + Stopped mail bill 

tutorial% 

With the —I option the process numbers are also displayed: 
tutorial% Joba —1 

[1] 3398 - Running du > disk.usage 

[2] 3405 Running Is —s j sort —n > myfile 

[3] + Stopped mail bill 

tutorial% 

Continuing with the same series, you can use the jg command to bring the Is job to the fore¬ 
ground: 

tutoria 1% fg %\b 

Is —s I sort —n > myfile 

tutorial% more myflle 

The fg (foreground) command runs a suspended or background job in the foreground. It restarts 
a previously suspended job or changes a background job to run in the foreground, allowing sig¬ 
nals or input from the workstation. In the above example you use fg to change the Is job from 
the background to the foreground since you want to wait for it to finish before looking at its out¬ 
put file* 

The stop command suspends a background job. 
tutorial% stop %1 

[1]— Stopped (signal) du > disk.usage 
tutorial^ 

You can use the kill command to terminate a background or suspended job immediately. In 
addition to job numbers, you can give it process numbers as arguments, as displayed by ps. 
Thus, in the above example, you can terminate the running du command with kill: 
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tutorial% kin %1 

[1] Terminated du > disk.usage 

tutorial% 

The notify command (not the set command variable mentioned earlier) reports termination of a 
specific job at the time the job finishes instead of waiting for the next prompt. 

If a job running in the background tries to read input from the workstation, it is automatically 
stopped. You can give input to the job, when you return such a job to the foreground. If 
desired, you can return the job to the background until it requests input again. This is illus¬ 
trated in the following sequence where the 9 (substitute) command in the text editor might take 
a long time: 

tutorial% ed blgfile 
120000 

1,$s/thisword/thatword/ 

“Z 

Stopped 
tutorial% bg 
fl] ed bigfile & 
tutorial% 

. . . some foreground commands 
[1] Stopped (tty input) ed bigfile 
tutorial% fg 
ed bigfile 
w 

120000 

q 

tutorial% 

After you called the a command, you stopped the ed job with "Z, and then put it in the back¬ 
ground using bg. Sometime later when the a command was finished, ed tried to read another 
command and was stopped because jobs in the background cannot read from the workstation. 
Typing the fg command returned the ed job to the foreground where it could once again accept 
commands from the terminal. 

To stop all background jobs when they are about to write output to the workstation, use the stty 
(set terminal output) command: 

tutorial% «tty tostop 
tutorial% 

This prevents messages from background jobs from interrupting foreground job output so you 
can run a job in the background without losing workstation output. You can also use it for 
interactive programs that sometimes have long periods without interaction. Thus each time a 
background job prompts for more input, it stops before the prompt. You run the job in the fore¬ 
ground using fg, give it more input and, if necessary, stop and return it to the background. This 
9tty command is a good thing to put in your Aogin file if you do not like output from background 
jobs interrupting your work. It can also reduce the need for redirecting the output of back¬ 
ground jobs if the output is not very big: 
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tutor la 1% Btty tostop 
tutorial% wc bugefile & 

[1] 10387 
tutorial% ed text 
. . . some time later 

q 

[1] stopped (tty output) wc hugofile 

tutor ial% fg %wc 
wc hugefile 

13371 30123 302577 

tutor ial% stty —tostop 
tutorial% 

Thus after some time the wc command, which counts the lines, words and characters in a file, 
had one line of output. When it tried to write this to the workstation it stopped. By restarting 
it in the foreground, it writes on the workstation exactly when you are ready to look at its out¬ 
put. Stty (osfop allows bg job output to go to the workstation. Programs which attempt to 
change the mode of a terminal will also stop, whether or not tostop is set, as it would be very 
unpleasant to have a background job change the state of a terminal. 

Since the jobs command only displays jobs started in the currently executing C-Shell, it knows 
nothing about background jobs started in other login sessions or within C-Shell files. Use the pa 
command in this case to find out about background jobs not started in the current C-Shell. 

1.3.7. The C-SkelTs Working Directory 

As mentioned in Ftlenames and Pathnames, the C-Shell is always in a particular working direc~ 
tory. The cd (change directory) command changes the working directory of the C-Shell, that is, 
changes the directory you are located in. 

It is useful to make a directory for each project you wish to work on and to place all files related 
to that project in that directory. The mkdtr command (make directory) creates a new directory. 
The pwd (print working directory) command reports the absolute pathname of the working direc¬ 
tory of the C-Shell, that is, the directory you are located in. Thus in the example below, Sam 
creates and moves to the directory newpaper, where he might place a group of related files: 

tutorial% pwd 
/usr/sam 

tutorial% mkdlr newpaper 
tutorial% cd newpaper 
tutorial% pwd 
/usr/sam/newpaper 
tutorial% 

No matter where you move to in a directory hierarchy, you can return to your home login direc¬ 
tory by typing cd without any arguments: 

tutorial^ cd 
tutorial% pwd 
/usr/sam 
tutorial% 

The name (dot dot) always means the directory above the current one in the hierarchy, so to 
change the C-Shell’s working directory to the one directly above the current one, use: 
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tutorial% cd.. 
tutorial% pwd 
/usr 

tutorial% 

The name can be used in any pathname. To change to the directory programs contained in 
the directory above the current one, type: 

tutorial% cd ../programs 

If you have several directories for different projects under, say, your home directory, use this 
shorthand notation to switch easily between them. 

The C-Shell always remembers the pathname of its current working directory in the variable 
cwd. You can also request that the C-Shell remember the previous directory when you change to 
a new working directory. If you use the pushd (push directory) command in place of the cd com¬ 
mand, the C-Shell saves the name of the current working directory on a directory stack before 
changing to the new one. You can see this directory stack at any time by typing the directories 
command dirs: 

tutorial% pushd newpaper/references 
-/newpaper/references 
tutorial% pushd /usr/Hb/tmac 
/usr/lib/tmac "/newpaper/references 
tutorial% dlrs 

/usr/lib/tmac "/newpaper/references " 

tutorial% 

tutorial% 

The list is displayed in a horizontal line, reading left to right, with a tilde (") shorthand for 
your home directory — in this case /««f/aam. The directory stack is displayed whenever there 
is more than one entry in it and it changes. Dirs is usually faster and more informative than 
pwd since it shows the current working directory as well as any other directories remembered in 
the stack. The pushd command without any arguments alternates the current directory with the 
first directory in the list. 

The popd (pop directory) command without an argument returns you to the directory you were 
in prior to the current one, discarding the current directory from the stack and forgetting it. 
Typing popd several times in a series takes you backward through the directories you had 
changed to with the pushd command: 

tutorial% popd 
•'/newpaper/references " 
tutorial% popd 

tutorial% 

There are other options to pushd and popd to manipulate the contents of the directory stack and 
to change to directories not at the top of the stack; see the csh Commands Reference Manual 
page for details. 

Regardless of what directory changes you make, the C-Shell remembers the working directory in 
which each job was started. It warns you if you try to restart a job in the foreground which has 
a different working directory than the current C-Shell working directory. Thus if you start a 
background job, change the C-ShelPs working directory, and then run the background job in the 
foreground, the C-Shell warns you that the working directory of the currently running fore¬ 
ground job is different from that of the C-Shell: 
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tutorial% dirs —1 
/doc/sam 

tutorial% cd myproject 
tutorial% dira 
''/myproject 
tutorial% cd prog.c 
1143 

Stopped 
tutorial% cd 
tutorial% la 
myproject 
textfile 
tutorial% fg 

ed prog.c (wd: “/myproject) 

The C-Shell warns you that the working directory of the ed program is ~/myproJect, not the 
current working directory of docfeam. The ed job was still in Idocf samImyproject even though 
the C-Shell had changed to jdocjearn. 

You get a similar warning when such a foreground job terminates or is suspended using the '‘Z 
STOP signal, since returning to the C-Shell again implies a change of working directory. 

tutorial% fg 

ed prog.c (wd: “/myproject) 

. . . after some editing 

q 

(wd now: “) 
tutorial% 

These messages are sometimes confusing if you use programs that change their own working 
directories. The C-Shell only remembers which directory a job is started in, and assumes the job 
stays there. The joho —1 option displays the working directory of suspended or background jobs 
when it is different from the current working directory of the C-Shell. 


l.S.8. Useful Built-in Commands 

This section describes several of the more useful built-in C-Shell commands. For a complete list, 
see csh in the Commands Reference Manual. 

The echo command plays back its argument list to the screen. It is often used in Shell scripts or 
as an interactive command to see what filename expansions will produce. We saw this earlier in 
Filename Expansion. To determine the effect of a command such as rm, type: 

tutorial^ echo rm [ca]* 

rm a aA aB aC cl clO ... cS c6 c7 c8 c9 
tutorial% 

Using echo here is a good way to learn the effects of the metacharacters without affecting any 
files or directories. 

The limit command restricts the use of resources. With no arguments, it displays the current 
limitations: 
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tutorial% limit 

filesize unlimited 

datasize 1984 kbytes 

stacksize 512 kbytes 

coredunpsize unlimited 
memoryuse unlimited 

tutorial% 

Limits can be set, for instance: 

tutorial% limit coredumpsize 128k 
tutorial% 

for the current login session. Most reasonable units abbreviations work. See the c$h Commands 
Reference Manual page for more details. 

Use repeat to repeat a command several times. To make four copies of the file data in the file 
four, type: 

tutorial% repeat 4 cat data » four 
tutorial% 

The setenv command sets variables in the environment. For example: 
setenv TERM sun 


or 


setenv TERM adm3a 

This sets the value of the environment variable TERM to ‘sun’ or ‘adm3a’, depending on your 
terminal. Unsetenv removes variables from the environment. 

The printenv user program displays the environment. It might show; 

tutorial% printenv 

HOME=/usr/lori 

SHELL=/bin/csh 

PATH=.:/:/bin:/usr/bin:/usr/lori/bin:/usr/local;/usr/local/bin:/usr/ucb:/etc:/usr/h 
TERM=sun 
USER=lori 

EXINIT=set noai wrapmargin=8 
tutorial% 

Use the source command noted before to force the current Shell to read commands from a file: 

tutor ial% source .cshrc 
tutorial% 

Running source on the .cshrc file makes any changes you made take effect immediately, that is, 
before the next time you login. 

Use the (imc command to time a command no matter how much CPU time it takes: 
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tutorial% time cp /etc/rc /usr/Bam/rc 
O.Ou 0.1s 0:01 8% 2+lk 3+2io Ipf+Ow 
tutorial% time wc /etc/rc /usr/sam/rc 


52 

178 

1347 /etc/rc 

52 

178 

1347 /usr/sam/rc 

104 

356 

2694 total 


O.lu O.ls 0:00 13% 3+3k 5+3io 7pf+0w 
tutorial% 

The first indicates that the cp command used a negligible amount of user time (u) and about 
1/iOth of a second system time (s); the elapsed time was 1 second (0:01); S% of CPU cycles over 
period when active; there was an average memory usage of 2k: bytes of program space and Ik 
bytes of data space over the CPU time involved (2+lk); the program did three disk reads and 
two disk writes (3+2io), took one page fault and was not swapped (Ipf+Ow). The word count 
command wc on the other hand used 0.1 seconds of user time and 0.1 seconds of system time in 
less than a second of elapsed time. The percentage ‘13%’ indicates that over the period when it 
was active, wc used an average of 13 percent of the available CPU cycles of the machine. 


1.4. Programming the C-Shell 

You can use the C-Shell to read and execute C-Shell command scripts. C-Shell scripts are files 
that contain a group of csh commands. 

A command script may be interpreted by saying: 

tutorial% csh script... 

where script is the name of the file containing a group of csh commands and is replaced by a 
sequence of arguments. The C-Shell places these arguments in the variable argv and then begins 
to read commands from the script. These parameters are then available through the same 
mechanisms which are used to reference any other C-Shell variables. 

You can make the file executable with the ckmod command: 

tutorial% chmod 755 script 
tutorial% 

If you place a C-Shell comment at the beginning of the Shell script as well, that is, begin the file 
with a character, then /bin/csh is automatically invoked to execute «cripf when you type: 

tutorial% script 

If the file does not begin with a then the standard Shell /bin/sk executes it. In this way, you 
can convert your older shell scripts to use csh. 


H.l. Variable Substitution 

After each input line is broken into words and history substitutions are done on it, the input line 
is parsed into distinct commands. Before each command is executed a mechanism known as 
variable substitution is done on these words. Keyed by the character this substitution 
replaces the names of variables by their values. Thus 

echo $argv 
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when placed in a command script echoes the current value of the variable argv to the output of 
the shell script. You must have argv set at this point; otherwise, it is an error. 

A number of notations are provided for accessing components and attributes of variables. The 
notation 

$?name 

expands to T’ if name is set or to ‘0’ if name is not set. This is the fundamental mechanism used 
for checking whether particular variables have been assigned values. All other forms of refer¬ 
ence to undefined variables cause errors. 

The notation 
$#name 

expands to the number of elements in the variable name. Thus 

tutorial% set argv-(a b c) 
tutorial% echo Sfargv 
1 

tut:orial% echo $#argv 
3 

tutorial% unset argv 
tutorial% echo $?argv 
O 

tutorial% echo $argv 
Undefined variable: argv. 
tutorlal% 

It is also possible to access the components of a variable which has several values. Thus 
$argv[l] 

gives the first component of argv or in the example above ‘a’. Similarly 
$argv[$#argv] 
would give ‘c’, and 
$argv[l—2] 

would give ‘a h\ Other notations useful in shell scripts are: 

$rt 

where n is an integer as a shorthand for 
$argv [n| 

the nth parameter and 

$* 

which is a shorthand for 
$argv 
The form 
$$ 

expands to the process number of the current Shell. Since this process number is unique in the 
system it can be used to generate unique temporary filenames. The form 
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$< 

is quite special. It is replaced by the next line of input read from the Shell’s standard input, not 
the Shell script it is reading. This is useful for writing Shell scripts that are interactive, reading 
commands from the workstation or terminal, or even writing a Shell script that acts as a filter, 
reading lines from its input file. Thus the sequence 

echo —n 'yes or no?* 
set a=($<) 

writes out the prompt ‘yes or no?’ without a newline and then reads the answer into the variable 
‘a’. In this case would be ‘0’ if either a blank line or end-of-file (^D) is typed. 

There is one minor difference between ‘$n’ and ‘$argv[»]’. The form ‘$argv[n]’ will yield an 
error if n is not in the range ‘1—S^argv’, while ‘Sn’ will never yield an out of range subscript 
error. This is for compatibility with the way older shells handled parameters. 

Another important point is that it is never an error to give a subrange of the form ‘n—if there 
are less than n components of the given variable then no words are substituted. A range of the 
form ‘m—n’ likewise returns an empty vector without giving an error when m exceeds the 
number of elements of the given variable, provided the subscript n is in range. 

See Programming Tools for the Sun Workstation for more information on programming the C- 
Shell. 


1.5. C-Shell Metacharacter Summary 

The following table lists the special csk and Sun system characters. A number of these characters 
also have special meaning in expressions. See the csh manual section for a complete list. 


Table 1-1: Syntactic Metacharacters 


; separates commands to be executed sequentially 

I separates commands in a pipeline 

( ) brackets expressions and variable values 

& follows commands to be executed without waiting for completion 

Table 1-2; Filename Metacharacters 

/ separates conponents of a file's pathname 

? expansion character matching any single character 

* expansion character matching any sequence of characters 

[ ] expansion sequence matching any single character from a set 

used at the beginning of a filename to indicate home directorie 
{ } used to specify groups of arguments with common parts 
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\ 

A 

n 


Table 1-3: Quoting Metacharacters 

prevents meta-meaning of following single character 
prevents meta-meaning of a group of characters 
like but allows variable and command expansion 



Table 1-4: Input/output Metacharacters 

< indicates redirected input 

> indicates redirected output 


Table 1-5: Expansion/substitution Metacharacters 


$ indicates variable substitution 

I indicates history substitution 

: precedes substitution modifiers 

* used in special forms of history substitution 

' indicates command substitution 


Table 1-6: Other Metacharacters 


# 

X 


begins scratch file names; indicates Shell comments 
prefixes option (flag) arguments to commands 
prefixes job name specifications 
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Using the Bourne Shell^ describes the UNIX system version 7 Shell called the Bourne Shell («A). 
The design of the Bourne Shell, here referred to simply as the ‘Shell,’ is based in part on the ori¬ 
ginal UNIX Shell and the PWB/UNDC Shell. Similarities also exist with the command interpreters 
of the Cambridge Multiple Access System and of CTSS. 

See the Commands Reference Manual for more details on sk. Also see the references in the 
appendix for more information. 


2.1. What is a Shell? 

A Shell is both a command language and a programming language that provides an interface to 
the operating system and interprets commands which you type. The Shell’s primary purpose is 
to translate command lines typed at the workstation into system actions, such as the invocation 
of other programs. Because the Shell is a user program, just like any you might write, there is 
more than one available. The Shell you get when you log in is specified in your password file 
entry field, which contains the pathname to it. 

The Shell’s features include variables, control-flow primitives, parameter passing, subroutines, 
interrupt handling, and string substitution. The Shell supports control structures such as while, 
if-tken-else, case, and for. Two-way communication is possible between the Shell and commands. 
String-valued parameters, typically filenames or flags, may be passed to a command. Commands 
set a return code that may be used as Shell input. 

You can use the Shell to modify the environment in which commands run by redirecting input 
and output to files, by calling processes that communicate through ptpea, and by defining a direc¬ 
tory searching sequence in the file system to call commands. Commands can be read either from 
the workstation or from a file, so command procedures can be stored for later use. 

A Shell in the Sun operating system acts mostly as a medium through which other programs are 
invoked. The Shell is thus distinguished from the command interpreters of other systems both 
by the fact that it is just a user program, and by the fact that it is used almost exclusively as a 
mechanism for invoking other programs. 

The Sun system supports two shells, the Bourne Shell and the C-Shell, which are available as the 
programs sh and csh respectively. The Shell you get when you log in is specified in a field in 
your password file entry, which contains the pathname to the Shell to be used. If your system is 
running the Bourne Shell, it displays the ‘$’ prompt. The C-Shell displays the *%’ prompt. 


* The material in this chapter is derived from An Introduction to the Bourne Shell, S, R. Bourne. 
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2.2. Logging In 

The Shell is a program that runs automatically when you log in to the Sun system. When you 
log in, the Shell reads any commands from the file .profile, if you have such a file in your login 
directory, before reading any commands from the workstation. 

It reads each command that you type and interprets what you’ve asked for. The Shell expands 
any file-matching metacharacters you use. If you redirect the standard input and output, or the 
diagnostic output, the Shell handles that too. The Shell examines the command you type in, 
calls up the command from wherever it lives, and passes all the arguments to that program and 
starts it up. 

The Shell is the interface between you the user and the Sun system utility programs. Because it 
is just an ordinary program, you can use it by typing the command sh followed by an argument, 
which is the name of a file containing Sun system commands. See Programming the Shell for 
some simple examples. 


2.3. Changing the Shell Prompt 

The Shell displays a prompt before reading a command. By default this prompt is ‘$ ’. Or you 
can change it to the string ‘yesdear’, for example: 

PSl=yesdear 

If a newline is typed and further input is needed, the Shell displays the prompt ‘> ’. Sometimes 
mistyping a quote mark causes this. If it is unexpected, an INTERRUPT (X) returns the Shell 
to read another command. You can change this *>’ prompt by saying, for example: 

PS2=inore 


2.4. Simple Shell Commands 

Simple Shell commands consist of one or more words separated by blanks. The first word is the 
name of the command to be executed; any remaining words are passed as arguments to the com¬ 
mand. These arguments can be flag arguments or filenames. For example, to print the names of 
users logged in, type the who command: 

$ who 

lori console Jul 26 07:40 

$ 

This shows user ‘lori’ is logged in on the console. 

To show a detailed list of files in the current directory, use the Is command with the —I option: 


2-2 


Revision A of 15 April 1985 





Beginner's Guide 


Using the Bourne Shell 


$ lB-1 
total 1064 


-rw-r- 

-1 - 

1 

lori 

181 

Jul 

25 

17:14 

Makefile 

-rw-r- 

-1 - 

1 

lori 

460654 

< etc. > 

Jul 

24 

17:16 

doc.cat 

-rvr-r- 

-1- 

1 

lori 

67 

Jul 

23 

12:31 

tabs 

-rw-r- 

$ 

-X- 

1 

lori 

22980 

Jul 

17 

15:42 

uucp 


The argument -*I tells Is to print status information, size and the creation date for each file. 


Background Commands 

To execute a command, the Shell normally creates a new process and waits for it to finish. You 
may run a command in the background without waiting for it to finish. For example, to put a 
call to the C compiler in the background, you type the cc command line with an ampersand 
at the end of the line: 

$ cc pgm.c & 

321 

$ 

This compiles the file pgm.c. The trailing & is the operator that instructs the Shell not to wait 
for the command to finish. To keep track of a process, the Shell reports its process number, 321 
in this case, following its creation. You can obtain a list of currently active processes using the 
ps (process status) command. 


2 . 4 . 2 . Input!Output Redirection 

Most commands produce output on the standard output, that is your workstation or terminal. 
You can send this output to a file instead of the standard output by typing, for example: 

$ la —1 > file.llst 
$ 

The Shell interprets the notation >file.li8t and does not pass it as an argument to Is. If file.list 
does not exist, the Shell creates it; otherwise the output from Is replaces the original contents of 
file.list. You can append output to a file with the ‘>>’ notation: 

$ la —1 » flle.liat 
$ 

A second Is —/ directory contents listing is appended to the first in file.list. In this case file.list is 
also created if it does not already exist. 

A command can take the standard input from a file instead of the workstation by typing the ‘<’ 
redirection character as in: 

$ wc < file.liat 

30 234 1546 file.list 

$ 

The command wc reads its standard input, in this case redirected from file.list, and displays the 
number of characters, words and lines found. If only the number of lines is required, use the —1 
option: 
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$ wc —1 < flle.llBt 

30 file.list 

$ 


2.4-^^ Pipelines and Filters 

Two or more commands connected by the pipe operator ‘1’ form a pipeline, A filter is a com¬ 
mand that reads its standard input, transforms it in some way, and displays the result as output. 
Pipelines and filters are often used together. 

Use the pipe operator, ‘[’ to connect the standard output of one command to the standard input 
of another. In the example above, the two commands Is —/ ^ file,list and wc —/ <C file.list were 
run to get one desired result. You can run both together; that is, you can process the Is output 
with the wc command by typing: 

$ Is —1 j wc 

19 146 963 

$ 

Here, the output of the Is command is piped as input to wc. Two commands connected in this 
way constitute a pipeline, and the overall effect is the same as: 

$ Is -1 > file.list; wc < file.Ust 
$ 

except that no file.list is used. Instead a pipe connects the two processes, which are run in paral¬ 
lel. Pipes are unidirectional and synchronization is achieved by halting wc when there is nothing 
to read and halting Is when the pipe is full. 

A filter command transforms its standard input in some way. One such filter, grep, selects from 
its input those lines that contain some specified string. For example, to list those lines, if any, 
from Is that contain the string ‘all’, type: 

$ Is I grep all 
mail.all 
news.all 
refs.all 
shell.all 
summ.all 
$ 

Grep takes the output of Is and searches for the string ‘all’. Another useful filter is sort, which 
orders or ‘sorts’ a file in several different ways. For example, to display an alphabetically sorted 
list of names in the file name.list, type: 

$ sort name.list 

Dan 

Joe 

Mary 

Hike 

Susie 

$ 

Read more about sort in the Commands Reference Manual. 
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A pipeline may consist of more than two commands. You can pipe h to grep and then to wc, for 
example: 

$ Is i grep all j wc -1 

5 

$ 

to display the number of filenames in the current directory containing the string ‘all’ as in the 
example above. 


S.4 4- Filename Expansion *[]’ 

As described in the Simple Shell Commands section, the first word of a command is the name of 
the command to be executed. Other words on the command line are arguments to that com¬ 
mands. Many commands accept arguments that are filenames. For example, use the Is com¬ 
mand with the ~1 option to display information relating to the file main.c: 

$ Is —1 main.c 

-rw-r-T-- 1 lori 136783 Jul 26 11:10 main.c 

$ 

The file main.c is the argument to the Is command. 

The Shell provides a mechanism for generating a list of filenames that match a pattern. For 
example, to generate, as arguments to Is, all filenames in the current directory that end in ‘.all’, 
type: 


$ U-l*.all 

-rw-i —1 - 

1 

lori 

57022 

Jul 

23 

12:15 

mail.all 

-rw-i —1 - 

1 

lori 

25643 

Jul 

23 

12:15 

news.all 

-rw-j—I— 

1 

lori 

4965 

Jul 

25 

16:50 

refs.all 

-rw-i —i— 

1 

lori 

136783 

Jul 

26 

11:10 

shell.all 

-rw-i— 1 — 

$ 

1 

lori 

34121 

Jul 

25 

17:14 

summ.all 


The Shell expands to match any string including the null string, that is, all the files whose 
names end with ‘.all’ in the working directory. In general patterns are specified as follows: 

• Matches any string of characters including the null string. 

? Matches any single character. 

[ ] Matches any one of the characters enclosed. A pair of characters separated by a 
minus matches any character lexically between the pair. 

To match all names in the current directory beginning with one of the letters a through z, use: 


$ Is -1 [a-sj* 








mailref; 








total 121 








-rw^r--i— 

1 

lori 

460654 

Jul 

24 

17:16 

doc.cat 

-•rw-i- i - 

1 

lori 

292152 

Jul 

24 

16:47 

doc.tbl 



< etc. 

> 





*rw-i- 1 - 

1 

lori 

58334 

Jul 

20 

17:42 

mail.all 

-rw-i —1 - 

1 

lori 

201 

Jun 

30 

23:18 

mailO.nr 


$ 

The Shell expands the ‘[a-z]*’ argument to all files beginning with any lower-case letter. Be 
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careful; this may display a very long list of files. 

The character matches all names that consist of a single character in the directory. So you 
can use the U command with on fuerffredflest and say: 

$ Is /usr/fred/test/r 
/usr/fred/test/a 
/usr/fred/test/b 
$ 

to match the files a and 6. If no filename is found that matches the pattern, the pattern is passed 
unchanged as an argument, and ‘No match.’ is displayed. 

This filename expansion notation saves typing and provides name selection according to some 
pattern. It makes finding a file easy. For example, to find and display the names of all core files 
in subdirectories of /nsr/fred, say: 

$ echo /usr/fred/*/core 

/usr/fred/misc/coro /usr/fred/test/core 
$ 

The finds the files core in subdirectories misc and teat. As you saw before, echo is a standard 
command that displays its arguments, separated by blanks. This last search feature however, 
can be expensive, requiring a scan of all subdirectories of fuarffred. 

There is one exception to the general rules given for patterns. The character (‘dot’) at the 
start of a filename must be explicitly matched. For instance, using to match any character 
does not match a at the beginning of a filename: 

$ echo * 

Makefile doc.tbl file shell.all uucp 
$ 

Instead, it echos all filenames in the current directory not beginning with even if the current 
directory is your home directory, which contains your .profile file. To match the *•’ character at 
the beginning of a filename, type: 

$ echo. * 

$ 

This echos all those filenames that begin with including the names and ‘.Z which mean ‘the 
current directory’ and ‘the parent directory’ respectively. 

See the Shell Metacharacter 5«mmary section for a quick reference list of the metacharacters. 


Quoting the Metacharacters with ' and ‘\' 

Characters that have a special meaning to the Shell, such as ‘ < >’, | are called meta¬ 

characters. Any character preceded by a ‘ \’ is quoted or escaped and loses its special meaning, 
if any. The ‘ \’ is called the escape character and elided so that to echo a single type: 

$ echo \f 
? 

$ 

And to echo a single ‘<’, type: 
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$ echo \< 

< 

$ 

The ‘ \’ prevents the Shell from using the special meanings of and 

To continue long commands over more than one line, the sequence \nc«;/mc is ignored. 

The ‘ \’ is convenient for quoting single characters, but when more than one character needs 
quoting, it is clumsy and error prone. Enclose the string of characters between single quotes. 
For example, to quote a series of four asterisks so that they lose their special matching capabil¬ 
ity, type: 

$ echo XX *xx 
xx****xx 
$ 

The quoted string may not contain a single quote, but may contain newlines, which are 
preserved. This quoting mechanism is the most simple and is recommended for casual use. 

A third quoting mechanism using double quotes prevents interpretation of some but not all meta¬ 
characters. 


2.5. Programming the Shell 

Use the Shell to read and execute commands contained in a file. A file containing commands is 
called a command procedure or Shell procedure. 

A simple Shell procedure uses the echo command: 

$ cat > welcome 
echo Good morning! 

"D 

$ 

To call the Shell to read commands from welcome, use the th command: 

$ sfa welcome 
Good morning! 

$ 

In general, this format looks like: 

$ eh file [ args ... j 
in which eh calls commands from file. 

You can either execute a Shell procedure with »h or make the procedure executable. The chmod 
(change mode) command can make a file readable, writable and executable. 

For example, to make welcome executable, type: 

$ chmod q-x welcome 

Following this, the command: 

$ welcome 
Good morning! 

$ 
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is equivalent to: 

$ sh welcome 
Good morning! 

$ 

You can also use the ckmod command in the following format: 

$ chmod 755 welcome 
$ welcome 
Good morning! 

$ 

which has the same effect as the first. See the Commands Reference Manila/ for details on the 
chmod command. 

An executable command is noted with an asterisk in an Is —F directory listing. So if you 
were to list the directory contents now, it would show among other things: 

$ Is-F 

< etc. > 
welcome* 

n 



The Shell also has the capability to define a named variable and assign a value to it. The sim¬ 
plest way to set a Shell variable is to use an assignment statement 

variable=value 

You can then use the assigned value by preceding the name of the variable with a dollar sign: 

$variable 

Now make a file called bliss which contains the assignment statements: 

food=bread 
drink5=wino 
person=thou 

echo $food, $drink^ $person ....Ah! 

Make bliss executable with ckmod, and execute it: 

$ chmod 755 bliss 
$ bliss 

breads wine, thou ....Ah! 

$ 

As another example, make a string-searching 
Is I grep $1 

Make it executable with ckmod and use it 
current directory: 

$ chmod 755 Isg 
$ IsgW 
allnames 
allx 

mail.all 

o 


file called Isg (for ‘Is-grep’) that contains: 

to find filenames containing the string ‘all’ in the 
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You can thus use Shell procedures and programs interchangeably. 

As well as providing names for the positional parameters, the number of positional parameters in 
the call is available as $#. You can refer to the name of the file being executed as $0. 

There are some predefined Shell variables, some of which are modifiable and some of which are 
read-only. You have already seen; 

HOME — Set to the user’s home directory. 

PATH — Set of directories that the Shell searches in order to find commands. 

PSl — Primary prompt string, here the 

You can also set a Shell variable from the output of a command. For example: 

$ now=*date* 

$ echo $now 

Fri Aug 12 08:23:12 PST 1983 
$ 

Note that the characters surrounding the command are grave accents, not apostrophes. 

To set a Shell variable equal to a value contained in a file, use: 
todo='cat plan' 

This calls the cat command with the argument plan, where the plan file contains: 

Eat breakfast. 

Go to work. 

The resulting value of ‘$todo’ is: 

$ echo $todo 
Eat breakfast. 

Go to work. 

$ 

A different type of Shell variable is one which is passed to the Shell procedures when it is called. 
These arguments called positional parameters and are referred to by number, $1, $2, ... Con¬ 
sider the following simple Shell procedure: 

$ cat > reverse 
echo $0 $5 $4 $3 $2 $1 
-D 

$ chmod 755 reverse 
$ reverse do re mi fa so la 
la so fa mi re do 
$ 

You can also use the flow control programming constructs if., else, while., do, and others to con¬ 
trol the action taken by the procedure. See the Programming Tools for the Sun Workstation for 
more information on programming the Shell, 
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2.6* Shell Metacharacter Summary 

o 

Table 2-1: Syntactic Metacharacters 

j pipe symbol 

; command separator 

& background commands 

( ) command grouping 

< input redirection 

> output redirection 

Table 2-2: Filename Expansion Metacharacters 

* match any character(s) including none 

? match any single character 

match any of the enclosed characters 

o 

Table 2-3: Substitution Metacharacters 

${..,} substitute Shell variable 
'substitute command output 

Table 2-4: Quoting Metacharacters 

\ quote the next character 

quote the enclosed characters except for 
**...'* quote the enclosed characters except for $ ' \ ” 
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Chapter 3 


Mail User's Guide 


The Mail User's Guide^ describes how to use the mail program to send and receive messages. It 
also provides summary information and quick reference pages at the end for easy use. It assumes 
you are familiar with the C-Shell, a text editor like vi or ex, and some of the common Sun system 
commands. If you are not, read the Introduction to the Sun System in Part One of this manual. 
For additional details on Sun system commands, consult the Commands Reference Manual for 
the Sun Workstation. Set-up information for the mail facility is in the System Administration 
Guide for the Sun Workstation . 

Mail provides a communication facility for sending and receiving mail among users on the same 
host, users on different hosts linked to your local network, and users linked to the ARPANET, and 
UUCP networks. You use a set of editing commands to manipulate messages, and to define and 
send mail to names which label user groups. 

Briefly, here is how mail handles messages: mail divides incoming mail into its constituent mes¬ 
sages so you can deal with them in any order you please. The mail system collects the messages 
for you from other people in a file, called your system mailbox. When you login, the system 
notifies you if there are any messages waiting in this system mailbox. When you read your mail 
using mail, it reads your system mailbox and separates that file into the individual messages that 
have been sent to you. You can then read, reply to, delete, or save these messages. Each mes¬ 
sage is marked with its author, the date sent, and the message subject among other things. 


3.1. Sending Mail 


The mail command has three ways to send mail, depending on where your recipient has a login 
account. If he has a host machine linked to your local network, use the method described in 
Sending Mail on the Local Network. If he has a login account on the same host as yours, use the 
method described in Sending Mail on the Same Host. If your recipient logs in on a machine con¬ 
nected to yours by UUCP, use the method described in Sending Mail on the Network. 


S.1.1. Sending Mail on the Local Network 

To send mail to users on other hosts linked to yours on the local network, use the mail command 
followed by the login name and the host machine name of your recipient; for example, type: 


The materia! in this guide is derived from the Mail Reference Manual, Kurt Shoens, Craig Leres. 


Revision A of 15 April 1985 


3-1 



Mail User's Guide 


Beginner's Guide 


tutorial% mail Joe^Venus 

Is the meeting planned for this afternoonf 

"D 

EOT 

tutorial% 

This sends mail to ‘joe’, which is the login name of the person you’re sending mail to. Joe’s host- 
name is ‘venus’, which is where he has an account and logs in. End your message with a "D (an 
EOT) at the beginning of a line. Mail echoes EOT and returns you to the Shell. 

The message ‘joe’ reads consists of the message you typed, preceded by several header lines tel¬ 
ling who sent the message (your login name), the date and time it was sent, and various other 
details. 

If, while you are composing the message you decide that you do not wish to send it after all, you 
can abort the letter with your current interrupt character (the default is "C). Typing a single 
INTERRUPT causes mail to display: 

(Interrupt -- one more to kill letter) 

Typing a second INTERRUPT saves your partial letter in the file deadJetter in your home direc¬ 
tory and aborts the letter. Once you have sent mail to someone, there is no way to undo the 
act, so be careful. 


3A,2. Sending Mail on the Same Host 

Sending mail to a plain login name without a hostname sends mail to that person assuming he 
has an account on your machine. To send a message to ‘roger’, who has a login account on your 
host, type: 

tutor i a 1% mail roger 

Let’s play tennis this afternoon. 

*D 

EOT 

tutorial% 

End your message with a (an EOT) at the beginning of a line as before. Mail echoes EOT 
and returns you to the Shell. Later, the user ‘roger’ to whom you sent mail receives the mes¬ 
sage: 

You have mail. 


or 


You have new mail. 


or 


New mail has arrived. 

to tell him he has a message waiting. 

If you want to send the same message to several other people, you can list their login names on 
the command line. For instance: 
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tutorial% m^l John marty david 
Meeting at three o*clock. 

Please be on time. 

EOT 

t:utorial% 

sends the reminder to John, Marty, and David. 


SJ.S. Sending Mail on the Network 

If your recipient logs in on a machine connected to yours by the telephone line network called 
UUCP (unix to Unix copy), you must know the list of machines through which your message must 
travel to arrive at his site. So, if his machine is directly connected to yours, you can send mail 
to him using his hostname, the M’ or ‘bang’ character, and his login name. If you are using the 
C-Shell as our example shows, you must also escape the special ‘!’ character with a backslash ‘ \’. 
For example: 

tutorial% mall venu8\!Joe 

sends mail to the user ‘joe’ whose uucp hostname is ‘venus’. The general syntax is: 
tutorial% mall kostname\lnam€ 

If your message must go through an intermediate system first, use the syntax: 

tutorial% mall intermediate\lhostname\lus€rname 

Ask your system administrator about a ‘map’ of all the systems in the network connected to your 
site. 

There are several advanced facilities to learn about in the section Sending Mail with Tilde 
Escapes. 


3.2. Reading Your Mail 

If, when you log in, you see the message: 

Last login: Tuo Aug 6 13:42:21 on console 

Sun UNIX 4.2 UNIX (Release 1.1.1) (SUN) #4:Fri Jan 11 00:20:28 PST 1985 

You have mail. 

tutorial% 

you can read the mail by typing simply: 

tutorial% mall 

Mail responds by displaying its version number and date and then listing the messages you have 
waiting. Then it prompts you and waits for your command. The messages are assigned numbers 
starting with 1, so you refer to the messages with these numbers. Consider the following: 

Mall version 2.17 12/26/82. Type ? for help. 

"/usr/spool/lori * *: 2 messages 2 new 

>N 1 Steve Wed Sep 21 09:21 12/277 "Weekly Meeting" 

N 2 wendy Tuo Sep 20 22:55 
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Mail keeps track of which messages are ‘new’, that is, have been sent since you last read your 
mail, and which messages are ‘read’, that is, that you have read. New messages have an N next 
to them in the header listing and old, but unread messages have a U next to them. Mail keeps 
track of new/old and read/unread messages by putting a header field called ‘Status’ into your 
messages. 

To look at a specific message, use the prin^ command, which may be abbreviated to simply p. 
You can examine the first message above by typing: 

& print 1 
Message 1: 

From Steve Tue Aug 2 10:28:33 1983 
Date: 2 Aug 83 10:28:27 PDT (Tue) 

From: Steve (Steve Smith) 

Subject: Weekly Meeting 

Message-Id: <8308021728.AA05502@sun.uucp> 

Received: by sun.uucp (3.320/3.14) 

id AA05502; 2 Aug 83 10:28:27 PDT (Tue) 

To: henry 
Status: R 

Meeting at three o'clock. 

Please be on time. 

& 

Many mail commands that operate on messages take a message number as an argument like the 
print command. These commands have a notion of a current message. When you enter the mail 
program, the current message is initially the first new message. Thus, you can often omit the 
message number and use a simple p to display the current message: 

& p 

Another shorthand method is to display a message by simply giving its message number. To 
display the first new message, say: 

& 1 

Frequently, it is useful to read the messages in your mailbox in order, one after another. You 
can read the next message in mail by simply typing a newline. As a special case, you can type a 
newline as your first command to mail to type the first unread message. 


3.3, Replying to Mail 

If you wish to send a reply immediately after reading a message, you can do so with either the 
reply or the Reply command. There is a distinct difference between the two commands. 

Sometimes you will receive a message that has been sent to several people and wish to reply only 
to the person who sent it. In this case, use a simple lowercase r to reply to the sender only. A 
reply, like type, takes a message number as an argument. To reply to the sender and to every¬ 
one who received the original message, use the Reply command. Type in your reply, followed by 
a "D at the beginning of a line, as before. Mail displays EOT and the ampersand prompt to indi¬ 
cate its readiness to accept another command. 

In our example, if you wish to reply to the first message after reading it, use the command: 
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& Reply 
To: Steve 

Subject: Re: Weekly Meeting 

and enter your letter. You are now in the message collection mode, and mail gathers up your 
message up to a "D. Note that it copies the header from the original message to make it easy to 
recognize. If there are other header fields in the message, that information will also be used. 
For example, if your letter has a ‘To:’ header listing several recipients, mail sends your reply to 
those same people as well. Similarly, if the original message contained a ‘Cc:’ (carbon copies to) 
field, your reply goes to those users, too. Mail is careful, though, not to send the message to you, 
even if you appear in the ‘To:’ or ‘Cc:’ field, unless you ask to be included explicitly. More on 
this later. 

When you use the Reply command to respond to a letter, there is a problem of figuring out the 
names of the users in the ‘To:’ and ‘Cc:’ lists ‘relative to the current machine.’ If the original 
letter was sent to you by someone on the local machine, then this problem does not exist, but if 
the message came from a remote machine, the problem must be dealt with. Mail uses a heuristic 
to build the correct name for each user relative to the local machine. So, when you reply to 
remote mail, the names in the ‘To:’ and ‘Cc:’ lists may change somewhat. After typing in your 
letter, your correspondence looks like: 

& Reply 
To: Steve 

Subject: Weekly Meeting 

Thanks for the reminder 
"D 
EOT 
& 

The Reply command is especially useful for sustaining extended conversations over the message 
system, with other ‘listening’ users receiving copies of the conversation. Abbreviate the Reply 
command to R once you get the hang of things. 

Use replysender to respond to the sender only and use replyall to respond to everyone who 
received the message regardless of how the replyall option is set in your .mfliYrc file. In other 
words, replyall and replysender override all other settings. The replyall option is different than 
the replyall command; see Setting Your Options with for a description of the replyall 
option. 

If you wish, while reading your mail, to send a message to someone, but not as a reply to one of 
your messages, send the message directly with the mail command, which takes as arguments the 
names of the recipients you wish to send to. For example, to send a message to Wendy, tyjpe: 

& mail wendy 

Your presentation yesterday was very Informative. 

B*D 

EOT 

& 

Normally, each message you read is saved in your mailbox or mbox file in your login directory at 
the time you leave mail Often, however, you will not want to save a particular message you 
have received because it is only of passing interest. To avoid saving a message in mbox, delete it 
by typing: 
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& delete 1 

This makes message 1 from Steve disappear altogether, along with its number. Abbreviate the 
delete command to d. 


3,4. Customizing Your Mail 

There are several ways to customize the mail facility. If you have accounts on several systems 
and want to direct your mail to a single account, you need a .forward file in the home directories 
of those other accounts. You can also use the set and alias commands to tailor many mail 
features to your personal uses. 


Forwarding Your Mail from Other Accounts 

If there is a large number of systems at your site or if you are linked to USENET, you may have 
accounts on several machines. To forward your mail to a single account where mail will notify 
you that you have mail, create a .forward file in the home directories of all the accounts from 
which you want mail forwarded. For example, you may have an account on Venus’ where other 
users sometimes send you mail, but you usually log in to your account on ‘tutorial’. Create a 
.forward file on your account on Venus’ and add: 

sam@tutorial 

substituting your login name for ‘sam.’ Mail sent to your account on Venus’ will then be for¬ 
warded to your account on ‘tutorial’. 

Another way of forwarding mail is to use aliases. See Streamlining Your Mail with ‘alias ^ for 
details. 


3.4-2- Setting Your Options with ‘seV 

Set has two forms, one for setting a binarg option and one for setting a valued option. Binary 
options are either on or off, while valued options let you select from several choices. For exam¬ 
ple, you can choose which editor to use by setting the EDITOR option. You can use these options 
after entering mail or you can set them permanently by putting the appropriate line in your 
.login or .mailrc file. To use them from mail, you type: 

& set option 

To include them in your .login or .mailrc file, edit the file to include the line: 
set option 

A complete list of moi/options appears in Additional Features. 

As a C-Shell (csh) user, you will be notified when new mail arrives if you inform the C-Shell of 
the location of your system mailbox in the directory fusrfspool/mail in a file with your login 
name. If your login name is ‘karen’, you can make csh notify you of new mail by including the 
following line in your .cshrc file in your home directory: 

■et maIl=/u8r/8pool/mall/kftren 
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Another useful option is ask, which informs mail that you want to be prompted for a subject 
header to be included in the message. To set the ask option in mail, type: 

& set ask 

To set this option permanently, put the line set ask in your .mailrc file in your home directory. 

Set the replyall option if you want reply to respond to everyone who received a message and 
Reply to respond to the sender only. In a sense, the replyall option reverses the meanings of the 
reply and Reply commands. 

Another useful option is hold, which tells mail to keep your messages in the system mailbox 
instead of moving them to your mbox file in your home directory as it normally does when you 
leave mail. 

Use valued options to adapt mail to your persona! use. For example, the SHELL option tells 
which Shell you like to use, and is specified by: 

& set SH£LL=/bln/8h 

Note that no spaces are allowed in ‘SHELL=/bin/sh.’ A default Shell is used if none is specified. 

Another important valued option is cri, which prevents long messages from flying by too quickly 
for you to read them. Setting the crt option sends any message longer than a given number of 
lines through the paging program more. Try setting this option for your workstation as: 

a( set crt—34 

(or 24 if you are using a terminal) to paginate messages that will not fit on your screen. More 
displays a screenfull of information, then shows -MORE--. Type a space to see the next screen- 
full or RETURN to see the next line. It is not necessary to type in these set commands each time 
you run mail. See the discussion of .mailrc in Streamlining Your Mail with ‘alias\ 


3 . 4 . 3 . Streamlining Your Mail with 'alias* 

Mail has an alias adaptation, similar to the C-Shell. An alias is simply a name which stands for 
one or more real user names. When you send mail to an alias, you are really sending it to the 
list of real users associated with it. For example, define an alias for the members of a project, so 
that you can send mail to the whole project by sending mail to just a single name. Suppose that 
the users in a project are named Dan, Rick, Tom, and John. Define an alias ‘project’ for their 
project group by typing: 

& alias project dan rick tom John 

You can then send mail to all of them by typing: 

& mail project 
< etc. > 

-D 

EOT 

tutorial^ 

Use alias to provide a convenient name for someone whose user name is inconvenient. For exam¬ 
ple, if a user named Margaret Cunningham has the login name ‘margaret’, you can set an alias 
with: 


& alias mar margaret 

so that you can send mail to the shorter name, ‘mar’. 
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The alias and set commands let you customize mail, but you wouldn’t want to have to retype 
them each time you enter mail. To make them more convenient to use, put the set options and 
aliases you want in your .mailrc file in your home directory. For example, a .mailrc file can look 
like: 

set ask nosave crt=24 SHELL=/bin/csh 
alias project dan rick tom john 

What happens here is that mail always looks for two files when it is invoked. It first reads a 
system-wide file /usr/lib/Maiirc, then your user-specific file, .mailrc in your home directory. 
The system administrator at your site maintains the system-wide file, which contains set com¬ 
mands that are applicable to all users of the system. 

The mail delivery system sendmail provides a system-wide aliases file called /usr/lib/aliases 
which provides a more efficient way to keep a large database of mail aliases. For details, refer to 
the Sendmail Installation and Operation Guide in the System Administration Manual for the Sun 
Workstation. 


3.5. More on Reading Mail 

You have seen that you can invoke mail with command line arguments that name people to send 
the message to, or with no arguments to read mail. Specifying the —f flag on the command line 
causes mail to read messages from a file other than your system mailbox. For example, if you 
have a collection of messages in the file letters, use mail to read them with: 

tutorial% mall—f letters 
''letters'*; 3 messages 
& n 

>1 lori Tue Jul 26 14:55 11/102 "Con^jany Party'' 

<etc.> 

& 1 

From lori Tue Jul 26 14:55:09 1983 
Date: 26 Jul 83 14:55:04 PDT (Tue) 

From: lori (Lori Rosen) 

Subject: Con^any Party 

Message-Id: <8307262155 .AA04140<§!sun.uucp> 

Received: by sun.uucp (3.320/3.14) 

id AA04140; 26 Jul 83 14:55:04 PDT (Tue) 

To: Steve 
Status: R 

Please make plans for the coiqpany 
party in October. 

& 

You can use all the mail commands described in this manual to examine, modify, or delete mes¬ 
sages from your letters file, which is rewritten when you leave mail with the quit command 
described below. 

Since mail that you read is saved in the file mboz in your home directory by default, you can 
read it by using simply: 
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tutor ial% m^l —f 
''/usr/lori/mbox'*: 7 messages 
& 

Normally, messages that you examine using the print command are saved in the mboz file in your 
home directory if you leave mail with the quit command described below. If you wish to retain a 
message in your system mailbox you can use the preserve command to tell mail to leave it there. 
Preserve accepts a list of message numbers, just like print and may be abbreviated to prc. 

Messages in your system mailbox that you do not examine are normally retained in your system 
mailbox automatically. If you wish to have such a message saved in mbox without reading it, use 
the mbox command to save it. For instance: 

& mbox 2 
& quit 

Saved 1 message In mbox 

Held 1 message in /usr/spool/mail/lori 

tutorial% 

saves the second message in mbox when you give the quit command. The mbox command is also 
the way to direct messages to your mbox file if you have set the hold option described above. 
You can abbreviate mbox to mb. 


3,6. Printing a Mail Message 

To print a message, save the message in a file, and then send it to your printer: 

text of mail 
& B good.letter 

"/usr/evan/good.letter" [New file} 37/1530 
& q 

tutorial% pr good.letter | Ipr -Fprinter 
tutorial% 


3.7. Quitting Mail 

When you have read all the interesting messages, you can finish the mail session with t|ie quit 
command. Quit does different things with the messages depending on whether you read a mes¬ 
sage, skipped over it, or deleted it: 

• Messages that you read but didn’t delete are appended to mbox in your home directory. 

• Messages which you simply skipped over and didn’t delete are kept in the system mail¬ 
box so you can read them the next time you use mail 

• Deleted messages are gone forever. 

Note that you can retrieve deleted messages with the u (undelete) command as long as you are 
still in mail Once you quit the mail program however, deleted messages are irretrievable. 

To quit mail, type: 


Revision A of 15 April 1985 


3-9 



Mail User's Guide 


Beginner's Guide 


& quit 

Saved 1 message in mbox 

Held 1 message in /usr/spool/mail/lori 

tutorial% 

You can abbreviate the quit command to g. 

If you wish for some reason to leave mail quickly without altering either your system mailbox or 
mbox, type: 

& X 

tutorial% 

(short for exit) which immediately returns you to the Shell without changing anything. 

If, instead, you want to execute a Shell command without leaving mail, type the command pre¬ 
ceded by an exclamation point, just as in the text editor. For instance: 

& !date 

Tue Jul 26 12:32:12 PDT 1983 
I 

& 

displays the current date without leaving mail. 



3.8. Mail Help — 


Type a question mark 

&r 

to get a brief summary of the mail command abbreviations: 

c <directory> 

chdir to directory or home if none given 

d <message Iist> 

delete messages 

e <message list> 

edit messages 

f <message list> 

show from lines of messages 

h 

print out active message headers 

m <user list> 

mail to specific users 

n 

goto and type next message 

p <message list> 

print messages 

pre <message list> 

make message go back to system mailbox 

q 

quit, saving unresolved messages in mbox 

r <message list> 

reply to sender only of messages 

R <message list> 

reply to messages 

s <messagel list> file 

append messages to file 

t <message list> 

type messages (same as print) 

top <message list> 

show top lines of messages 

u <message list> 

undelete messages 

w <message list> file 

append messages to file, without from line 

x 

quit, do not change system mailbox 

! 

shell escape 


A <message list> consists of integers, ranges of same, or user names separated 
by spaces. If omitted. Mail uses the last message typed. 
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3.9. Collecting Groups of Messages in Folders 

Mail includes a simple facility for maintaining groups of messages together in folders. 

To use the folder facility, put a line like: 

set folder ^letters 

in your ,mailrc file to indicate where your folder directory should be kept. Each folder of mes¬ 
sages is a single file, and all of your folders are kept in that directory. If, as in the example 
above, your folder directory does not begin with a 7,’ mail assumes that your folder directory is 
to be found starting from your home directory. Thus, if your home directory is /««r/pcraon the 
above example puts your folder directory in /««^/pcraon//e^^ef^. 

Anywhere a filename is expected, you can use a folder name, preceded with For example, to 
put a message into a folder with the save command, use: 

& save +record8 

"/usr/username/letters/records*‘ [New file] 13/272 
& 

This saves the current message in the records folder. If the records folder does not yet exist, it 
is created. Note that messages which are saved with the save command are automatically 
removed from your system mailbox. 

To copy a message into a folder without removing it from your system mailbox, type: 

& copy -frecords 

"/usr/username/letters/records' ’ [Appended] 11/282 
& 

This copies the current message into the records folder and leaves a copy in your system mail¬ 
box. The ‘appended’ message indicates that you already have a message in the recordsIfolder. 
Copi/ is identical in all other respects to save. 

Use the folder command to read the contents of a different folder. For example: 

& folder -{-records 

causes mail to close the file it is currently reading (as if you had typed q) and direct its attention 
to the contents of the records folder. All of the commands that you can use on your system 
mailbox are also applicable to folders, including print, delete, and reply. To inquire which folder 
you are currently editing, use simply; 

& folder 

To list your current set of folders, use the folders command: 

& folders 

If you want to start reading one of your folders, use the —f option described previously. For 
example: 

tutorial^ mall —f +recordB 

reads your records folder without looking at your system mailbox. 


Revision A of 15 April 1985 


3-11 



Mail User's Guide 


Beginner's Guide 


3.10. Sending Mail with Tilde Escapes 

While typing in a message to be sent to others, it is often useful to be able to invoke the text 
editor on the partial message, display the message, execute a Shell command, or do some other 
auxiliary function. Mail provides these capabilities through ‘tilde escapes,’ which consist of a 
tilde at the beginning of a line, followed by a single character which indicates the function to 
be performed. 


8.10.L Displaying the Message Text with 

If you are typing in a long message and want to to display the text of the message so far, use the 
‘"p’ escape: 

tutorial% midl lorl 
A very long message ... 

"P 


Message contains: 

To: lori 

Subject: Conpany Party 
A very long message ... 

(continue) 

The ‘~p’ displays a line of dashes, the recipients of your message, and the text of the message so 
far. Since mail requires two consecutive "C’s (RUBOUTs, INTERRUPTS, Dasras) to abort a letter, 
you can use a single "C to abort the output of ‘~p’ or any other escape without killing your 
letter. 


3.10.2, Editing a Message — ^'^e* and 

If you are dissatisfied with the message as it stands, you can use a text editor on it. To use the 
default line editor ex, type: 

'e 

The ‘"e’ escape copies the message into a temporary file for editing. After modifying the message 
to your satisfaction, write it out and quit the editor. Your screen displays: 

(continue) 

after which you may continue typing text which will be appended to your message, or type "D at 
end the message. Mail provides a standard text editor, but you can override this default by set¬ 
ting the valued option ‘EDITOR’ to something else. For example, you might prefer to use the vi 
display editor from Berkeley instead of the ez editor. Edit your .login file to contain: 

tetenv EDITOR /uir/ucb/vl 

Mail also defines a default visual display editor, vi. To use vi for editing your current message, 
use the escape: 

"'v 

The ‘"v’ escape works like ‘"e’, but invokes the visual rather than the text editor. If it does not 
suit you, you can set the valued option ‘VISUAL’ to the pathname of a different editor. 
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S.IO.S, Including a File in Your Message with 

If you want to read the contents of some file into your message, the escape appends the 
named file: 

"r datafile 

“datafile” 14/512 

In this case, datafile is added to your current message. If the read is successful, the number of 
lines and characters appended to your message is printed, after which you may continue append¬ 
ing text. Mail complains if the file doesn’t exist or can’t be read; for example: 

tutorial% mall lorl 
Subject: Con^any Party 
budget 

budget: No such file or directory. 

The filename may contain Shell metacharacters like and ‘?’, which are expanded according to 
the conventions of your Shell. 


SAO.j^, Using the 'dead.letteF File with '~d^ 

Similar to the ‘~r’ escape is the ‘~d’ escape which reads the file dead.letter in your home direc¬ 
tory. For instance: 

•d 

'‘/usr/lori/dead.letter * * 2/24 

reads in dead.letter to your current message. You can use ‘"d’ to recycle a message you aborted 
with '‘C, since mail copies the text of aborted messages into dead.letter. 


3.10.5. Saving Message Text in a File with '^w* 

To save the current text of your message in a file, use the ‘"“w’ escape: 

“w itinerary 
“itinerary”: 7/180 

Mail displays the number of lines and characters written to the file, after which you may con¬ 
tinue appending text to your message. You can use Shell metacharacters in the filename, as with 
‘V. 


3.10.6. Forwarding a Message with ‘"'m’ and 

If you are sending mail frorn within matTs command mode, you can read a message sent to you 
into the message you are writing with the escape: 

& mail lorl 

Subject: Cozqpany Party 

"m 4 

Interpolating: 4 
(continue) 

which reads message 4 into the current message, shifted right by one tab stop. You can name 
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any non-deleted message, or list of messages. 

You can also forward messages without having them indented by a tab stop in the text with the 
escape. 

& lorl 

Subject: Con^jany Party 

•f 4 

Interpolating: 4 
(continue) 


3.10.7, Adding People to the Message List with ‘ V 

If, in the process of composing a message, you decide to add additional people to the list of mes¬ 
sage recipients, you can do so with the escape: 

namel nameS ... 

You may name as few or many additional recipients as you wish. Note that the users originally 
on the recipient list will still receive the message; you cannot remove someone from the recipient 
list with ‘"f. 


3.10.8. Adding a Message Subject with ^^s’ 

If you wish, you can pick a subject for your message or change the one you originally chose if 
you have the ask option set, by using the ‘"s’ escape: 

New Message Subject 

The ^''s’ replaces any previous subject with ‘New Message Subject.’ The subject, if given, is 
placed in the ‘Subject’ heading near the top of the message. It’s a good idea to use the ‘"p’ 
escape to see what the message will look like if you make a lot of changes which are not immedi¬ 
ately displayed as you type in text. 


3.10.9. Sending Copies with and 

If you want to ‘copy’ people on a message, use the ‘ c’ escape: 

"c namel nameS ... 

The ‘"^c’ escape adds the named people to the ‘Cc:’ list. 

To add blind copy recipients to a message, that is, people who will receive a copy of your mes¬ 
sage but whose names will not be listed on the message, use the ‘"'b’ escape: 

''b name 1 nameB ... 

Again, use ‘~p’ to see what the message will look like. 
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tutorial% mail lorl 
Subject: Coai^any Party 
text 

*c joe dan 
“b ehelley 
"P 


Message contains: 

To: lori 

Subject: Company Party 
Cc: joe dan 
Bcc; shelley 

text 

(continue) 


3JO JO. Editing the Header Fields with ‘"h* 

The recipients of the message together constitute the ‘To:’ field, the subject the ‘Subject:’ field, 
and the carbon copies the ‘Cc:’ field. If you wish to edit these fields in ways impossible with the 
‘"t’, ‘~s’, and ‘~c’ escapes, you can use the ‘~h’ escape, which displays each of the fields in turn: 

To: lori 

Subject: Con^any Party 
Cc: 

Bcc: 

(continue) 

The ‘~h’ escape first displays ‘To:’ followed by the current list of recipients and leaves the cursor 
at the end of the line. Typing in ordinary characters appends them to the end of the current list 
of recipients. You can also use your erase character Del to erase back into the list of recipients, 
or your kill character to erase them altogether. Typing a newline, advances to the ‘Subject’ 
field, where the same rules apply. Another newline brings you to the ‘Cc:’ field, and so on. 
Another newline leaves you appending text to the end of your message. You can use ‘~p’ to 
display the current text of the header fields and the body of the message. 


3.10Jl. Escaping to the Shell with '7' 

To escape to the Shell temporarily to execute a command, use the ‘"I’ escape: 

"'!pwd 

/usr/1ori/tutorial 
I 

You can use a Shell command and return to mailing mode without altering the text of your mes¬ 
sage. If you wish, instead, to filter your message through a Shell command, you can use the ‘~j’ 
escape: 

''\command 

(continue) 

which pipes your message through the command and uses the output as the new text of your 
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message. If the command does not produce any output, mail assumes that something is amiss and 
retains the old version of your message. A frequently-used filter is the command fmt, which 
justifies the message text. For example, you can type a message like the following and run it 
through fmt: 

tutorial% mail eteve 
Subject: Con^jany Party 

Please make plans for the company party In October. 

We have a 

lot of scheduling and budgeting to do. 

I will be on vacation 

for three weeks in September, 

BO we should firm up 
the plans before I leave. 

"'jfmt 

(continue) 

"D 

EOT 

tutorial% 

to send your recipient ‘steve’ the formatted version: 

From lori Fri Aug 5 16:18:02 1983 
Date: 5 Aug 83 16:17:55 PDT (Fri) 

From: lori (Lori Rosen) 

Subject: Con^any Party 

Message-Id: <8308052317.AA00232@sun.uucp> 

Received; by sun.uucp (3.320/3.14) 

id AA00232; 5 Aug 83 16:17:55 PDT (Fri) 

To: Steve 
Status: R 

Please make plans for the con^any party in October. We have a lot 
of scheduling and budgeting to do. I will be on vacation for three 
weeks in September, so we should firm up the plans before I leave. 


3.10.12. Escaping to ‘mair Command Mode with 

To escape to mail command mode temporarily, use the escape: 

’’imail command 

This is especially useful for reshowing the message you are replying to by using for example: 
It is also useful for setting options and modifying aliases. 


3.10.18. Changing the Tilde Escape and Using a Tilde as a Ttide 

If you want or need to change the escape character to something other than the tilde ‘ , use the 
‘escape^ option. For instance: 
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•et e8cape=] 

lets you use a right bracket instead of a tilde. Changing the escape character removes the spe¬ 
cial meaning of the tilde 

If you wish for some reason to send a message that contains a line beginning with a tilde, you 
must double it. Thus, for example: 

This line begins with a tilde. 

sends the line: 

""This lino begins with a tilde. 

If you ever need to send a line beginning with your new escape character, such as the right 
bracket as suggested above, double it, just as for 


3 . 10 . 14 . V Need Help — 

If you forget which tilde escape does what and need a quick reminder while you are sending 
someone a message, type the escape: 

•r 

The displays a brief summary of the available tilde escapes. 


3.11. Special Recipients 

As described previously, you can send mail to either user names or alias names. Special conven¬ 
tions provide the capability of sending messages directly to files or to programs. If a recipient 
name has a ‘/’ in it or begins with a ‘-f’, it is assumed to be the pathname of a file to which to 
send the message. If the file already exists, the message is appended to the end of the file. If 
you want to name a file in your current directory (that is, one for which a would not usually 
be needed) you can precede the name with So, to send mail to the file memo in the current 
directory, type: 

tutorial% mall ./memo 

If the name begins with a ‘4*’, it is expanded into the full pathname of the folder name in your 
folder directory. Sending mail to files can be used for a variety of purposes, such as maintaining 
a journal and keeping a record of mail sent to a certain group of users. You can keep a record 
automatically by including the full pathname of the record file in the alias command for the 
group. Using our previous alias example, you can say: 

alias project dan rick tom John /u8r/proJect/mall_rccord 

Then, all mail sent to ‘project’ is saved in the file /usr/project/maiLrecord as well as being sent 
to the members of the project. You can examine this file using mail —f. 

When you need to send mail directly to a program, preface the program name with a Mail 
treats recipient names that begin with a ‘|’ as a program to send the mail to. For example, you 
might write a project billboard program and want to access it using mail. To send messages to 
the billboard program, send mail to the special name ‘[ billboard’. You can set up an alias to 
refer to a ‘j’ prefaced name if desired. 
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Caveats: Because the Shell treats specially, you must quote the ‘j program’ on the command 
line to present it as a single argument to mail Surround the entire name with quotes. This also 
applies to use with the alias command. For example, if you want to alias ‘/^sr/local/bugfiler’ to 
‘bugfiler’, say: 

alias bugfller *| /uar/local/bugfiler* 


3.12. Additional Features 

This section describes some additional commands for handling lists of messages, receiving your 
mail, and setting options. 


3,12.1. Message Lists 

Several mail commands accept a message list as an argument. Along with print and delete, 
described above, there is the from command, which displays the message headers associated with 
the message list passed to it. Use from in conjunction with some of the message list features 
described below. 

A message list consists of a list of message numbers, ranges, and names, separated by spaces or 
tabs. Message numbers may be either decimal numbers, which directly specify messages, or one 
of the special characters or ‘$’ to specify the first relevant, current, or last relevant mes¬ 

sage, respectively. ‘Relevant’ means ‘not deleted’ for most commands, and ‘deleted’ for the 
undelete command. 

A range of messages consists of two message numbers separated by a hyphen. So, to display the 
first four messages, use: 

& print 1—4 

and to display all the messages from the current message to the last message, use: 

& print.—$ 

A name is a user name. The user names given in the message list are collected, and each mes¬ 
sage selected by other means is checked to make sure that one of the named users sent it. If the 
message consists entirely of user names, then every message that is relevant and sent by one of 
those users is selected. Thus, to display every message that peter sent to you, type: 

& print peter 

As a shorthand notation, you can specify simply to get every ‘relevant’ (same sense) message. 
So to display all undeleted messages, type: 

& print • 

To delete all undeleted messages, type: 

& delete * 

And to undelete all deleted messages, type: 

& undelete * 
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You can search for the presence of a word in subject lines with For example, to display the 
headers of all messages that contain the word ‘PASCAL’, say: 

& from /pascal 

Note that subject searching ignores upper/iower case differences. 


3.12.2. List of Commands for Receiving Mail 

This section describes all the mail commands available when receiving mail. 

& Icommand 

Escape to the Shell to process command. 

& — Go to the previous message and display it. 

& ? Display a brief help summary about mail commands. Same as help. 

alias Define a name to stand for a set of other names. Use this when you want to send 
messages to a certain group of people and want to avoid retyping their names. For 
example: 

alias gang jon marty stove evan darryl 

creates an alias gang, which expands to the five people ‘jon’, ‘marty’, ‘steve’, ‘evan’, 
and ‘darryl’. If the given alias already exists, the listed names are added to it. 

cd Change current directory. Cd takes a single argument, the pathname of the direc¬ 

tory to change to. If no argument is given, cd changes to your home directory. 

copy Copy messages into a file without deleting them when you quit. See save. 

delete Delete a list of messages. Reclaim deleted messages with the undelete command. 

dp Delete the current message and display the next message. The dp command is useful 

for quickly reading and disposing of mail. 

dt Same as dp. 

edit Edit individual messages using the text editor. Edit takes a list of messages as 

described under the type command and writes each into the file Messagez (where ‘x’ 
is the message number being edited) for editing. When you have edited the message, 
write the message and quit. Mail reads the message back and removes the file. You 
may abbreviate edit to e. 

else Mark the end of the tken-p&ri of an if statement and the beginning of the part to 

take effect if the condition of the if statement is false. 

endif Mark the end of an if statement. 

exit Leave mail without updating the system mailbox or the file you were reading. Thus, 

if you accidentally delete several messages, use exit to avoid scrambling your mailbox. 

file List the names of the folders in your folder directory. Same as folder. 

folder or folders 

Switch to a new mail file or folder. With no arguments, folder tells you which file 
you are currently reading. If you give it an argument name, it writes out changes 
(such as deletions) you have made in the current file and reads the new file. Use 
these special conventions for the name. 
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from 

headers 


help 

hold 

if 


Name 

Meaning 

# 

Previous file read 

% 

Your system mailbox 

%name 

Name’s system mailbox 

& 

Your "'/mbox file 

+folder 

A file in your folder directory 


Display header lines for each message in a list. To display all the message headers 
from iori’ for example, type: 

from Iori 

1 Iori Fri Jul 22 10:10:38 10/128 "Subject** 

2 Iori Wed Jul 27 10:15:20 11/120 

5 Iori Fri Jul 29 10:16:52 13/150 

Reprint the current list of message headers. When you start up mail to read your 
mail, it lists the message headers that you have. These headers tell you who each 
message is from, when it was sent, how many lines and characters each message has, 
and the ‘Subject:’ header field if present. In addition, mat/tags the message header 
of each message that has been the object of the preserve command with a ‘P’. A 
flags messages that have been saved or written. Finally, deleted messages are not 
shown at all. Headers (and thus the initial header listing) only lists the first so many 
message headers. The number of headers listed depends on the speed of your system. 
You can override this by specifying the number of headers you want with the screen 
command. Mail maintains a notion of the current ‘window’ into your messages for 
the purpose of displaying headers. Use the z command to move forward and back a 
window. You can change the notion of the current window directly to a particular 
message by using, for example: 

6 headers 40 

to move mfliTs attention to the messages around message 40, You can abbreviate the 
headers command to h. 

Display a brief help message about the mail commands. 

Hold a list of messages in the system mailbox, instead of moving them to the mboz 
file in your home directory. If you set the binary option hold, this will happen by 
default. Same as preserve. 


Execute commands in your .mailrc file conditionally depending on whether you are 
sending or receiving mail with the if command. For example, you can do: 

if receive 

commands,, . 

end if 

An else form is also available: 
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ignore 


list 

mail 


mbox 

next 


preserve 

Print 

print 

quit 


Reply 


if send 

commands. . . 


else 

commands. . . 

endif 


Note that the only allowed conditions are receive and send. 

Add the list of header fields named to the ‘ignore list.’ Header fields in the ignore list 
are not shown on your screen when you display a message so you can suppress the 
display of certain machine-generated header fields, such as Via which are not usually 
of interest. Use the Type and Print commands to display a message in its entirety, 
including ignored fields. If ignore is executed without arguments, it lists the current 
set of ignored fields. 

List the valid mail commands. 

Send mail to one or more people. If you have the ask option set, you are prompted 
for a subject to your message. Then you can type in your message, using tilde 
escapes as described earlier to edit, display, or modify your message. To send your 
message, type at the beginning of a line, or a alone on a line if you set the 
option dot. To abort the message, type two interrupt characters ("C) in a row or use 
the ‘^q’ escape. 

Send a list of messages to mhox in your home directory when you quit. This is the 
default action for messages if you do not have the hold option set. 

Go to the next message and show it. If given a message list, next goes to the first 
such message and shows it. For example, to go to the next message sent by sieve and 
show it, type: 

& next Steve 

You can abbreviate the next command to simply a newline, which means that you 
can go to and type a message by simply giving its message number or one of the 
magic characters ‘"’j or ‘$’. So, to display the current message, type: 

& • 

And to display message 4, say: 

& 4 


Keep a list of messages in your system mailbox when you quit. Same as hold. 

Like prinf, but also displays ignored header fields. See also print ignore. 

Display each message your on workstation. Abbreviate to p. Same as type. 

Leave mail and update the file, folder, or system mailbox you were reading. Mes¬ 
sages that you have examined are marked as ‘read’ and messages that existed when 
you started are marked as ‘old.’ If you were editing your system mailbox and if you 
have set the binary option hold, all messages which have not been deleted, saved, or 
mboxed are retained in your system mailbox. If you were editing your system mail¬ 
box and you did not have hold set, all messages which have not been deleted, saved, 
or preserved are moved to the mbox file in your home directory. 

Reply to a single message. The reply is sent to the person who sent you the message 
to which you are replying, plus all the people who received the original message, 
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except you. You can add people using the Y and "c tilde escapes. The subject in 
your reply is formed by prefacing the subject in the original message with ‘Re:’ unless 
it already begins so. If the original message included a ‘reply-to’ header field, the 
reply only goes to the recipient named by ‘reply-to.’ Type in your message using the 
same conventions available through the mail command. 

reply Reply to a one or more messages. The reply or replies if you are using this on multi¬ 
ple messages, is sent ONLY to the person who sent you the message, respectively, the 
set of people who sent the messages you are replying to. You can add people using 
the ‘"t’ and ‘“c’ tilde escapes. The subject in your reply formed by prefacing the sub¬ 
ject in the original message with ‘Re:’ unless it already begins so. If the original mes¬ 
sage included a ‘reply-to’ header field, the reply goes only to the recipient named by 
‘reply-to.’ You type in your message using the same conventions available through 
the mail command. The reply command is especially useful for replying to messages 
that were sent to enormous distribution groups when you really just want to send a 
message to the originator. 

replyall Reply to all names in the original message, regardless of how the replyall option is 
set. 

replysender 

Reply to the sender only, regardless of how the replyall option is set. 

save Save messages on related topics in a file. Save takes as an argument a list of message 
numbers, followed by the name of the file in which to save the messages. The mes¬ 
sages are appended to the named file, so you can keep several messages in the file, 
stored in the order they were put there. You can abbreviate the save command to s. 
You can save messages 1 and 2 in good.mail for example, by typing: 

& alt good.mail 

Saved messages are deleted and not automatically saved in mbox at quit time. They 
are not selected by the next command described above unless explicitly specified. 

set Customize mail with options or with valued options. See the Setting Custom Binary 

and Valued Options information that follows. Options can be binary, in which case 
they are on or off, or valued. To set a binary option on, do: 

set option 

where option is the option name. To give a valued option a value, say: 

Bet option=value 

Several options can be specified in a single set command. 

Shell Escape to the Shell to type commands to it. When you leave the Shell, you return to 
mail. Mail assumes the default Shell, but you can override this default by setting the 
valued option SHELL. 

set SHELL=/bin/sh 

source Read mai7 commands from a file. It is useful when you are changing your .rnailrc file 
and you need to read in the changes. 

top Display the first five lines of each addressed message in a message list. It may be 

abbreviated to t. If you wish, you can change the number of lines that top displays 
by setting the valued option toplines. On a CRT terminal, you might prefer: 
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set toplines—10 

Type Displays each message with header fields. Identical to the Print command. 

type Display a list of messages on your screen. If you have set the crt option to a number, 

and the total number of lines in the messages you are displaying exceeds that 
specified by crt, the messages are displayed by a paging program such as more. 
(Same as print). 

undelete 

Restore a deleted message. Only messages that have been deleted may be undeleted. 
This command may be abbreviated to u. 

unset Reverse the action of setting a binary or valued option. 

visual Invoke a display-oriented editor. The operation of the visual command is otherwise 
identical to that of the edit command. Both the edit and visual commands assume 
some default text editors. You can override these default editors with the valued 
options EDITOR and VISUAL for the standard and screen editors. The defaults are: 

EDITOR ==/usr /ucb/ex VISUAL=/uar /ucb/vl 

write Write the message into a file. Just like save, except that write deletes the first (nor¬ 
mally ‘From:’ line) and last (normally blank) lines. Write has the same syntax as save 
and can be abbreviated to simply w. Thus, you can write the second message by 
doing: 

& w 2 flle.save 

z Move the message header window forward. Type: 

& *+ 

Analogously, you can move to the previous window with: 

&. z— 

3.12.3. Setting Custom Binary and Valued Options 

This section describes each of the options in alphabetical order, including some that you have 
not yet seen. To avoid confusion, please note that the options are either all lowercase letters or 
all uppercase letters. We begin sentences with capitalized option names as a courtesy to English. 
Unless otherwise stated, the default value of all binary options is false (unset). 

EDITOR Define the pathname of the text editor to be used in the edit command and ‘ e’. If 
not defined, ez is used. A valued option. 

SHELL Give the pathname of your Shell. This Shell is used for the M’ command and 

escape. In addition, it expands filenames with Shell metacharacters like and in 
them. Default is esk. A valued option. 

VISUAL Define the pathname of your screen editor for use in the visual command and ‘"v’ 
escape. Invokes vi unless otherwise defined. A valued option. 

append Appends messages to the end of your mbox file rather than to the beginning. Nor¬ 
mally, messages are put in mbox in the same order that the system puts messages in 
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your system mailbox. A binary option. This option is set in the system file 
/usr/Hh/MaiLrc. So by default, messages are appended to the end of the system 
mailbox and, your mboz file. You may override it in your .mailrc or your system 
administrator may remove it, if desired. 

ask Prompt you for the subject of each message you send. If you respond with simply a 

newline, no subject field is sent. A binary option. 

askcc Prompt you for additional ‘carbon copy’ recipients at the end of each message. 

Responding with a newline shows your satisfaction with the current list. A binary 
option. 

autoprint 

Cause the delete command to behave like dt. After deleting a message, the next one 
is displayed automatically. This is useful for quickly scanning and deleting messages 
in your mailbox. A binary option. 

Designate the minimum numbers of lines displayed before the message is displayed by 
more for easier viewing. For example, set crt=30 causes any message longer than 
30 lines to be displayed with more, A valued option. 

Display debugging information. Same as using the —d command line flag. A binary 
option. 

Cause mail to interpret a period alone on a line as the terminator of a message you 
are sending. A binary option. This is set in the default system file /usr/lib/Matl.re. 
It may be removed or overridden in your ,mailrc. 

Allow you to change the escape character used when sending mail. Only the first 
character of the escape option is used, and it must be doubled if it is to appear as the 
first character of a line of your message. If you change your escape character, then 
loses all its special meaning, and need no longer be doubled at the beginning of a 
line. A valued option. 

Determine the name of the directory to use for storing folders of messages. If this 
name begins with a ‘/’ mail considers it to be an absolute pathname; otherwise, the 
folder directory is found relative to your home directory. 

Hold messages that have been read but not manually dealt with in the system mail¬ 
box to prevent them from being automatically swept into your mbox. A binary 
option. 

Ignore "C’s (or RUBOUT) characters from your system and echo them as ‘@’s’ while 
you are sending mail. The "C characters retain their original meaning in mail com¬ 
mand mode. Setting the ignore option is equivalent to supplying the —i flag on the 
command line. A binary option. 

ignoreeof 

Make mail refuse to accept your current EOF character (*D by default) as the end of 
a message. Ignoreeof also applies to mail command mode, and is related to dot 

keep Truncate mail system mailbox instead of deleting it when it is empty. This is useful 
if you elect to protect your mailbox, which you do with the Shell command: 

tutorlal% chmod 000 /wT/npool/mall/yourname 

where yourname is your login name. If you do not do this, anyone can probably read 
your mail. 


crt 

debug 

dot 

escape 

folder 

hold 

ignore 
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keepsave 

Retain all saved messages. When you save a message in a file, mail usually discards 
it when you quit. 


metoo 


nosave 


quiet 


record 


Include yourself as a recipient when sending mail to an alias. Otherwise, mail does 
not send you a copy if you are included in the alias. A binary option. 

Prevent mfliV from copying a partial letter to the dead.letter file in your home direc¬ 
tory when you abort a message with two "C’s (rubout’s). A binary option. 

Suppress the display of the mail version when mail is first invoked and the message 
number from the type command. A binary option. 

Name a record file to save your outgoing mail. Each new message you send is 
appended to the end of the file. A valued option. 


replyall Makes reply respond to everyone who received the message and Reply respond to the 
sender only. Setting replyall in the system-wide equivalent of .maiYrc called 
usr/lib/Maiirc makes this the default and sets it for everyone. 


screen Override any terminal speed consideration that may affect how mail prints the mes¬ 
sage headers. Usually, the faster your terminal, the more it displays. The value of 
screen specifies how many message headers you want displayed. This number is also 
used for scrolling with the z command. A valued option. 

send mail 

Use an alternate delivery system. Set the sendmail option to the full pathname of 
the program to use. Note: this is not for everyone! Most people should use the 
default delivery system. A valued option, set to the full pathname of the program to 
use. 


toplines 

Define the number of lines that the top command displays instead of the default five 
lines. A valued option. 

verbose Invoke sendmail with the — v flag to use verbose mode and announce expansion of 
aliases, etc. Equivalent to invoking mai/with the —v flag. A binary option. 


3.12.4> Command Line Options 

This section describes the use of ma#7 command line options. 

—N Suppress the initial printing of headers. For example, to get into mail, type: 

tutorial% madl -N 
& 

—d Turn on debugging information. Not of general interest. 

—f file Show the messages in file instead of your system mailbox. If file is omitted, mail 

reads mbox in your home directory. 

—I 

Ignore tty interrupt signals while typing in a mail message. You can still use ‘~q’ to 
interrupt the message. Useful on noisy phone lines, which generate spurious RUBOUT 
or Deleie characters. This is usually unnecessary if your INTERRUPT character is the 
default or if you’re not logged in over a phone line. (See the stty Shell command 
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in the Commands Reference Manual for details.) 
—n Inhibit reading of /usr/lib/Mail.rc. 


—8 string 

Denote the subject of a message when sending mail. If string contains blanks, sur¬ 
round it with quote marks. 

—u name Read nflmc^’s mail instead of your own. Unwitting others often neglect to protect 
their mailboxes, but discretion is advised. 

—T file Arrange to print on file the contents of the article-id fields of all messages that were 

either read or deleted. — T is for the readnews program and should NOT be used for 
reading your mail. 

—V Use the —v flag when invoking sendmail. This feature may also be enabled by set¬ 

ting the option verbose. Useful for diagnosing mail delivery problems. 


3.13. Message Format 

A sample message format is: 

From lori Wed Jul 27 10:16:52 1983 
Date: 27 Jul 83 10:16:45 PDT (Wed) 

From: lori (Lori Rosen) 

Subject: Company Cruise 

Message-Id: <8307271716.AA05188@sun.uucp> 

Received: by sun.uucp (3.320/3.14) 

id AA05188; 27 Jul 83 10:16:45 PDT (Wed) 

To: alison 
Status: R 

Messages begin with a from line, which consists of the word ‘From’ followed by a user name, fol¬ 
lowed by anything (usually null), followed by a date in the format returned by the cfimc library 
routine described in the Commands Reference Manual The dime date may be optionally fol¬ 
lowed by a single space and a time zone indication, which should be three capital letters, such as 
PDT. 

Following the from line are zero or more header field lines. Each header field line is of the form: 
naone: information 

Name can be anything, but only certain header fields are recognized as having any meaning. 
The recognized header fields are: article-id, hcc, cc, from, reply-to, sender, subject, and to. 
Other header fields are also significant to other systems; see, for example, the current ARPANET 
message standard for more on this topic, A header field can be continued onto following lines by 
making the first character on the following line a space or tab character. 

If any headers are present, they must be followed by a blank line. The part that follows is called 
the body of the message, and must be ASCII text, not containing null characters. Each line in 
the message body must be terminated with an ASCII newline character and no line may be 
longer than 512 characters. If binary data must be passed through the mail system, it is sug¬ 
gested that this data be encoded in a system which encodes six bits into a printable character. 
For example, you could use the upper and lower case letters, the digits, and the characters 
comma and period to make up the 64 characters. Then, you can send a 16-bit binary number as 
three characters. Pack these characters into lines, preferably lines about 70 characters long as 


3-26 


Revision A of 15 April 1985 



Beginner's Guide 


Mail User's Guide 


long lines are transmitted more efficiently. The programs fusrfbtnluuencodf and 
/usr/bin/uudecode are useful for encoding and decoding binary data into the recommended 
form. 

The message delivery system always adds a blank line to the end of each message. This blank 
line must not be deleted. 

The UUCP message delivery system sometimes adds a blank line to the end of a message each 
time it is forwarded through a machine. 

Note that some network transport protocols enforce limits on the lengths of messages. 
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3.14. Summary of Commands, Options, and Escapes 

This section gives a quick summary of the mail commands, binary and valued »et options, and 
tilde escapes. 

3 . 14 , 1 . *mair Command Summary 
The folio-wing table describes the commands. 
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Table 3-1: mat/Commands 


Command 

Description 

! 

Single command escape to Shell 

- 

Back up to previous message 

Print 

Show message with ignored fields 

Reply 

Reply to a message 

Type 

Show message with ignored fields 

alias 

Define an alias as a set of user names 

alternates 

List other names you are known by 

cd 

Change working directory, home by default 

copy 

Copy a message to a file or folder 

delete 

Delete a list of messages 

dt 

Delete current message, type next message 

endif 

End of conditional statement; see if 

edit 

Edit a list of messages 

else 

Start of else part of conditional; see if 

exit 

Leave mail without changing anything 

file 

Interrogate/change current mail file 

folder 

Same as file 

folders 

List the folders in your folder directory 

from 

List headers of a list of messages 

headers 

List current window of messages 

help 

Print brief summary of mail commands 

hold 

Same as preserve 

if 

Conditional execution of mail commands 

ignore 

Set/examine list of ignored header fields 

list 

List valid mail commands 

mail 

Send mail to specified names 

mbox 

Arrange to save a list of messages in mboz 

next 

Go to next message and show it 

preserve 

Arrange to leave list of messages in system mailbox 

print 

Show messages 

quit 

Leave mail; update system mailbox, mbox as appropriate 

reply 

Reply to author of message only 

replyall 

Reply to message and all other recipients 

replysender 

Reply to message sender only 

save 

Append messages, headers included, on a file 

set 

Set binary or valued options 

shell 

Invoke an interactive Shell 

top 

Show first so many (5 by default) lines of list of messages 

type 

Show messages 

undelete 

Undelete list of messages 

unset 

Undo the operation of a set command 

visual 

Invoke visual editor on a list of messages 

■write 

Append messages to a file, not including headers 

z 

Scroll to next/previous screenfull of headers 
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3. 14 .2. 'set' Command Option Summary 

The following table describes the options. Each option is shown as being either a binary 
valued option. 


Table 3-2: mai7 Binary and Valued Options 


Option 

Type 

Description 

EDITOR 

valued 

Pathname of editor for ‘~e’ and edit 

SHELL 

valued 

Pathname of Shell for shell, and ‘!’ 

VISUAL 

valued 

Pathname of screen editor for ‘~v’, visual 

append 

binary 

Always append messages to end of mboz 

ask 

binary 

Prompt user for ‘Subject:’ field when sending 

askcc 

binary 

Prompt user for additional ‘Cc’s’ at end of message 

autoprint 

binary 

Print next message after delete 

crt 

valued 

Set minimum number of lines before using more 

debug 

binary 

Display debugging information 

dot 

binary 

Accept alone on line to terminate message input 

escape 

valued 

Escape character to be used instead of 

folder 

valued 

Set directory to store folders in 

bold 

binary 

Hold messages in system mailbox by default 

ignore 

binary 

Ignore "C’s (RUBOUT) while sending mail 

ignore e of 

binary 

Don’t terminate letters/command input with D 

keep 

binary 

Don’t unlink system mailbox when empty 

keepsave 

binary 

Don’t delete saved messages by default 

me too 

binary 

Include sending user in aliases 

nosave 

binary 

Don’t save partial letter in dead.letter 

quiet 

binary 

Suppress printing of mail version 

record 

valued 

File to save all outgoing mail in 

replyall 

binary 

Reverse action of reply and Reply 

screen 

valued 

Size of window of message headers for e, etc. 

sendmail 

valued 

Choose alternate mail delivery system 

fcoplines 

valued 

Number of lines to print in top 

verbose 

binary 

Invoke sendmail with the — v flag 


or 


3-30 


Revision A of 15 April 1985 



Beginner's Guide 


Mail User's Guide 



SA^.S. ^maiV Command Line Flags 

The following table shows the command line flags that mail accepts. 


Table 3-3: mail Command Line Flags 


Flag 

Description 

-N 

Suppress the initial printing of headers 

-T file 

Article-id’s of read 

-d 

Turn on debugging 

-tfile 

Show messages in file or 

• 

—1 

Ignore tty interrupt signals 

— n 

Inhibit reading of 

—8 string 

Use string as subject in outgoing mail 

-T file 

Print article-id contents on file for read- 


news 

— u name 

Read name's mail instead of your own 

—V 

Invoke sendmail with the — v (verbose) flag 


Note: Do not use —T and —d for normal operation. 



$.14 4' Tilde Escape Summary 

The following table summarizes the tilde escapes available while sending mail. 


Table 3-4: mail Tilde Escapes 


Escape 

Arguments 

Description 

~! 

command 

Execute Shell command 

"c 

name ... 

Add names to ‘Cc:’ field 

"d 


Read dead.letter into message 

~e 


Invoke text editor on partial message 

"f 

messages 

Read named messages 

“■h 


Edit the header fields 


messages 

Read named messages, right shift by tab 

> 


Display message entered so far 

y 


Abort entry of letter; like INTERRUPT ("C or RUBOUT) 

~r 

filename 

Read file into message 

~s 

string 

Set ‘Subject:’ field to string 

~t 

name ... 

Add names to ‘To:’ field 

"v 


Invoke screen editor vi on message 

"w 

filename 

Write message on file 

1 

command 

Pipe message through command 


string 

Quote a in front of string 
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3,14.5, 'maiV Help 

Following is the help summary displayed when you type: 

&T 


c <directory> 
d <message list> 
e <message Iist> 
f <message list> 
h 

m <user list> 
n 

p <message Iist> 
pre <inessage list> 

q 

r <message list> 

R <message list> 
s <messagel list> file 
t <message list> 
top <message list> 
u <message list> 
w <message Iist> file 

X 

\ 


chdir to directory or home if none given 
delete messages 
edit messages 

show from lines of messages 
print out active message headers 
mail to specific users 
goto and type next message 
print messages 

make message go back to system mailbox 

quit, saving unresolved messages in mbox 

reply to messages 

reply to sender (only) of messages 

append messages to file 

type messages (same as print) 

show top lines of messages 

undelete messages 

append messages to file, without from line 
quit, do not change system mailbox 
shell escape 


A <message list> consists of integers, ranges of same, or user names separated 
by spaces. If omitted. Mail uses the last message typed. 
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The network news, or simply netnewt, is the set of programs that provide access to the User’s 
Network called USENET. This chapter describes how to use the network news and related pro¬ 
grams and provides a quick reference page for easy use. 

With netnews, you can post news articles for limited or very wide distribution on the USENET. 
You can post an article, which will be sent out to the network to be read by others interested in 
that topic. There are facilities for browsing through old news, posting follow-up articles, and 
sending direct electronic mail replies to the author of an article. 

Whenever you read the news, you are presented with interesting articles that you have not yet 
read. These are divided into topics or newsgroups. You can specify which topics you are 
interested in with a subscription list. At the end of this guide, there is a list of newsgroups to 
help you determine which newsgroups you may want to subscribe to. Netnews keeps old articles 
around until they expire, which is usually about two weeks, so you can browse through old news 
from time to time. 

USENET is a bulletin board shared among many computer systems in the computer science com¬ 
munity, around the United States, Canada, Europe, Asia, and Australia. USENET is a logical net¬ 
work, sitting on top of several physical networks, including uucp, BLICN, and Berknet. Sites on 
USENET include many universities, private companies and research organizations. 

USENET is useful in a number of ways: 

• to share useful information, 

• to report bugs and fixes without mass mailings, and 

• to have discussions involving many people at different locations without having to get 
everyone together. 

For additional options and details on the network news, refer to the Commands Reference 
Manual on readnews, ckecknews, postnews, and inews. 


4.1. Making the Connection with Your News Host System 

To use netnews, a host system at your site (the news host) must connect regularly by uucp to 
another site from which news can be forwarded. This must be arranged directly between your 
system administrator and the forwarding site. See the System Administration Manual for the 
Sun Workstation for more information. If your system itself is the news host, you can run rcfld- 
news directly. If the news host is another machine on your local Ethernet, you must do a remote 
login (rlogin). Let’s assume your news host system is called ‘mercury’. Log in to ‘mercury’ by 


* The material in this guide is derived from How to Read the Network New$, Mark R. Horton, Bell Tele¬ 
phone Laboratories. 
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typing: 

tutorial% rlogin mercury 

Last login: Tue Aug 5 13:41:36 on ttypO 

Sun UNIX 4.2 (Release 1.1.1) (SUN) #4: Fri Jan 11 00:20:28 PST 1985 
mercury% 

You are now ready to read the news. 

For additional information on how to connect your system to the USENET, refer to the System 
Administration Manual for the Sun Workstation. 

When you are finished reading the news, use ''D to logout from the news host: 

inercury% ""D 
Connection closed. 
tutorial% 


4.2. How to Read the News with ‘readnews’ 

The following assumes that your system ‘mercury^’ is directly hooked up to USENET via uucp. 

Use the readnews command to read the news: 

iQercury% readnews 

Header of news article 

For each newsgroup to which you subscribe, an article at a time is presented. You will be shown 

the article header, containing the name of the author, the subject, and the length of the article. 

You are asked if you want to read more. The three most common responses are: 

• Type y for ‘yes’ (or simply press RETURN) to display the rest of the message. A at 
the end of a long message indicates that readnews is waiting for you to finish reading the 
displayed part of the message before the next header forces it off the top of the screen. 
Type a space or press RETURN to see more of the message, 

• Type ‘n’ for ‘no’ to indicate you are not interested in the message; it will not be offered 
to you again. 

• Type ‘q’ for ‘quit’ to make a record of which articles you read (or refused) and to exit 
netnews. When you have read all the news, this happens automatically. The quit com¬ 
mand is useful if you are in a hurry and don’t have time to read ail the news right now. 
This updates .newsre if the —1 or —x options are not used. 

To see a complete list of possible responses, type ‘?’ for help. 


4.3. Reading News for the First Time 

If you are reading news for the first time, you may find yourself swamped by the volume of 
unread news, especially if the subscription list default is ‘all’. Decide which newsgroups you 
want to read about. If you are getting newsgroups in which you have no interest, you can 
change your subscription list as we show below. Also, bear in mind that what you see is prob¬ 
ably at least two weeks accumulation of news. If you want to just get rid of all old news and 
start anew, use the readnews command with the —p and —n options, which throw away all arti¬ 
cles and any diagnostic output into /dev/null, the “wastebasket” file. Note tnat this take a long 
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time, so it’s best to run the command in the background by typing an at the end of the com¬ 
mand line: 

mercury% readnewi —p —n all > /dev/null & 

[1] 2345 
mercury% 

This throws away all old news, recording that you have seen it. 

Once you catch up or ignore all the old news, the news comes in daily at a more manageable 
rate. If the daily rate is still too much you may wish to change your subscription list to exclude 
some of the high volume newsgroups. Finally, note that while you are displaying an article, you 
can type a "C (an INTERRUPT orDELcro) to throw away the rest of the article. 

Other commands you can type after seeing the article header are: 

U Unsubscribe from this newsgroup. Goes on to the next group. Your .newsrc file 

is edited to change the for that newsgroup to an preventing you from 
being shown that newsgroup again unless you edit your .newtrc file (see below). 

X Exit readnewa. Unlike quit, does not update the record of which articles you have 

read and pretends you never started readnewa, 

N newagroup 

Go on to the next newagroup. The remaining articles in the current newsgroup 
are considered ‘unread’ and are offered to you again the next time you read news, 

s filename 

Save the article in a file with the given filename. What usually happens is that 
an article is displayed, and then readnewa goes on to display the header of the 
next article before you get a chance to type anything. To write out the previoua 
message, that is, the last one you have read in full, use the form s- filename. 
Article is appended to file. Default is Articlea. 

T Reply to the author of the message. You are placed in the editor with a set of 

headers derived from the message you are replying to. Type in your message 
after the blank line. If you want to edit the header list to add more recipients or 
send carbon copies, for instance, you can edit the header lines. Anyone listed on 
a line beginning with “To:” or “Cc:” will receive a copy of your reply. A mail 
command is then started up, addressed to the persons listed in the header. Exit¬ 
ing the editor returns you to readnewa. Use r— to reply to the previous message. 
Beware that this may sometimes generate an incorrect address. Check the 
address and correct it with *h if necessary. Another variation on this is rd-, 
which puts you in SMAILER or mail by default, to type in your reply directly. 

f Poat a follow-up meaaage to the same newagroup. Type in the body of yov^ reply 

and type "D. This poata an article on thia newsgroup with the aame title aa the 
original article. Be sure your article ia worthy of poating; many follow-up articlea 
should be rephea. Uae f— ’ to follow up the previoua meaaage. If you type this by 
accident, type "(7 (an INTERRUPT) to abort the follow-up. Note that the people 
who administer the machines on USENET are concerned about people sending 
news to inappropriate newsgroups. We suggest you read several week’s worth of 
news and read up on network etiquette before posting any news. 

b Backup one article in current group. 
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k Mark remainder of articles in group as read. 

+ n Skip the article for now or skip n articles. The next time you read news, you are 

offered this article again. 

- Go back to the previous article. This toggles, so that two ’’s get you the 

current article. 

d Divide digest article. 

c Cancel an article you posted. 

r Reply to article author via mail 

t title Post follow-up article to the same newsgroup. This posts an article on this news- 
group with the same title as the original article. You are placed in the editor. 
Enter your message and exit. The f— command follows up a previous message. 
Another case, fd— allows you to type the follow-up in directly without having to 
use an editor. If you start this by accident, type to abort the follow-up. The 
default editor is vi unless you set it otherwise in your environment. 

8 I command 

Run command with article as input. 

Erase, Forget that this article was read. It will be offered again. Use 
e— to see if there have already been followups to the article. 

Shows the verbose article header with article ID path the date or the 
newsgroups; also H for an even more verbose header. 

Escape to Shell to execute command. 

Go to article number. 

Display current version of news software. 

Decrypt crypted jokes. 

Send article to system. 

Display a summary of valid commands. The is also displayed if 
you type any unrecognized command. 

Put a ’ after c, r, f , e, s , and h to indicate the previous article. 


e 

h 

! 

number 

V 

D 

X system 
? 


4.4. Printing a News Article 

To print a news article, save it in a file with s filename, and then send it to your printer: 

Article 10 of 12, or general; Mon 11:12. 

Subject: HP2621P Function Keys 
Path: ,.Icbosgd!henry 
Newsgroups: btl.general,net.followup 
(31 lines) More? [ynq] ■ hp.function.keys 
./hp.function.keys: New file 
(31 lines) More? [ynq] q 
mercury^ pr hp.function.keys | Ipr —Pprinter 
mercury% 

Remember that if you decide you want to write an article to a file after you have read it, 
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you have to use the to indicate the previous article: 

(31 lines) More? [ynq] »- hp.f^nctlon.keys 


4.5. Changing Your Subscription List 

If you don’t take any special action, you will subscribe to a default subscription list. This 
default varies locally. To find out your local default, type: 

iiiGrcury% readnews —• 

Subscription list: general,all.general,general 

Typically this list includes all newsgroups ending in ‘general’, such as ‘general’, and 
‘net.general’. 

To change this, create a file in your home directory named .ncwsrc and type as its first line: 
options —n newsgroup newsgroup newsgroup ... 

Continue long lines on subsequent lines by beginning them with a tab or space. The netnews 
system updates this file by writing update lines to record which articles you have read. 
Ignore these lines unless you want to edit them. For example, if you are creating a subscrip¬ 
tion list for the first time, and have already read news, you will find some update text in 
your ,newsrc file, recording which articles you have read. Put your options line before the 
first line of the file. For instance, a .newsrc file can look like: 

options -n general net.al fa.telecoin 

net.chess: 1-224 

net.games.rogue: 1-45 

net.games.trivia: 1-234 

The update text shows three articles and the options lines that subscribes to the three news- 
groups, ‘general,’ ‘net.ai’, and ‘fa.telecom.’ 

The easiest way to subscribe to news is to subscribe to “all”, and then use the “U”to unsub¬ 
scribe to newsgroups you don’t want to read. This way you will see new newsgroups as they 
are created, get a chance to evaluate them, and then unsubscribe to those that don’t interest 
you. 

To exclude certain newsgroups, you can also type: 

Inewsgroup 

and add the word ‘all’ as a wild card to represent any newsgroup. You can also use ‘all’ as 
a prefix or suffix to match a class of newsgroups. For example: 

options —n all !fa.ali tnet.Jokes !a]l.unlx-all 

subscribes to all newsgroups except for ARPANET news, jokes, and any UNIX information. 
The metacharacter is like ‘/’ to the Shell, and ‘all’ is like 


4.6. Submitting New Articles with ‘postnews^ 

Use the postnews command to submit a news article on a new topic. You are prompted for 
an article subject, newsgroup(s), article distribution, and your news. You are then put in the 
editor. Enter the text of your article after the blank lines, and exit the editor. This sends 
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your article immediately. 

mercury% postnewt 
Subject: 

Newsgroups (general): 

Distribution (general): 

Typt news, exit editor 
mercury% 

Typing RETURN after the ‘Newsgroups’ and ‘Distribution’ prompts uses the default news¬ 
group, ‘general.’ That is almost certainly a larger distribution than you want! To change the 
distribution, type the name of the newsgroup class you want the article distributed to. 
Although you can use any newsgroup name, ordinarily you’ll just type the name of the news- 
group class, such as ‘usa’ or ‘net’. Take an extra moment to think about how applicable 
your news is, and to what area of the country or world. Sending messages to people who 
have no interest in them is one of the most annoying problems on the net today. When 
creating a new article, specifying the newsgroup controls the level of distribution. 

If you change your mind about the headers while you are still in the editor, you can edit 
them as well. You can also add extra headers before the blank line. 

If your article is related to a previous article, you should use the f followup command to 
readnews, instead of posting a new article. This creates an article with references to the 
previous article, so that persons who are not interested in the topic can shut it off. 

You can also use: 

mercury% postnewB filename 

in which case postnews uses the specified filename as the article. 

If you make a mistake, get out of the editor without writing the article with :q for example. 
Inews lets you know that your incomplete news article was not sent: 

sq 

inews: You didn't really want to post THAT!. 

Article saved in /usr2/lori/dead.article 


4.7. Submitting News with ‘inews’ 

You can also use the inews command to send news. Inews provides several options for speci¬ 
fying such additional information as the article expiration date and the name of the Jender. 
A sample inews format is: 

mercury% Inews — t title —n newsgroup [—e expiration date] [—f sender] 
body of article 

EOT 

mercury% 

Inews does not prompt you like postnews does. 

You can also use an editor with inews to prepare the body of your article. Edit your file, 
then type: 

mercury% Inews — t title [—n newsgroup} < file 
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to send the edited file as your news article. A sample command line looks like: 

m6rcury% inewt —t seminar ~n net.mlcro ~e next ftrlday < semlnfo 

This article announces a seminar to the ‘net.micro’ newsgroup readers. This expiration date 
option is useful if you are announcing a meeting for a particular date after which the 
announcement will no longer be valid. 

On some systems, it is possible to post news articles by sending mail. See the section on 
mail in User Interfaces in this guide or refer to mail in the Commands Reference Manual. 


4.8. Browsing Through Old News 

Readnews command line options that help you find an old article again are: 

—n newsgroups 

Restricts your search to certain newsgroups. 

—X Ignores the record of articles read kept in your .newsrc file. This displays all 

articles in all newsgroups to which you subscribe, even those which you have 
already seen. It also prevents readnews from updating the .newsrc file. 

—a date Asks for news received since the given date. Note that even with the —a option, 
only articles you have not already seen are displayed, unless you combine it with 
the —X option. Articles are kept on file until they expire, typically after two 
weeks. 

—t titles 

Restricts the query to articles mentioning one of the titles in the title of the arti¬ 
cle. If you try: 

mercury% readnews —n net.unix-wizards —x —a last friday—t setuid 

you see all articles in newsgroup net.unix-wizards since last Friday about the 
setuid feature. The —t option finds articles about the specific keyword; it does 
not find articles about ‘suid’, ‘Setuid’, nor articles with no title or whose author 
did not use the word ‘setuid’ in the title. 

—1 Lists only the headers of articles — a useful form for browsing through lots of 

messages. 

—p Prints the messages without asking for any input, 

—r Produces articles in reverse order, from newest to oldest, 

—f Prevents any follow-up articles from being printed. 

—h Prints articles in much less verbose format. 


4.9. Getting News When You Log In — Your Morning Newspa¬ 
per 

To be told if there is any news when you first log in, put ckecknews or readnews in your 
.login or .profile file on your account on your news host. This way you are reminded of news 
when you log in to the news host. 
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The readnews command tries to find all unread news (assuming you are going to read it), and 
takes a lot of time to do it, so it’s better to use the smaller, faster checknews, which tells you 
if there is any news. Checknews was designed especially for a login file. There are also 
options to be silent if there is or is not news, and to start up readnews automatically if there 
is news. 

The checknews options are: 

—y Print ‘There is news’ if there is any news arrives during a login session. This is 

the default if no other options are specified. 

— V If both —V and — y are given, instead of printing ‘There is news’, print ‘News: 

newsgroup giving the name of the first newsgroup containing unread news. 

—n Print ‘No news’ if there is no unread news. 

—e Start up readnews if there is any unread news. Any additional arguments after 

the —e are passed to readnews. 

—q Make checknews quiet. The exit status indicates news: 0 means ‘no news’ and 1 

means ‘there is news.’ It does not print a message. 

Thus, checknews —yn tells you whether there is any unread news. Checknews —y tells you if 
there is news, and is silent if there is no news. 


4.10. Creating New Newsgroups 

To create a newsgroup, post an article to an appropriate ‘general’ newsgroup suggesting the 
new newsgroup. For example, for a new ‘net’ or ‘fa’ newsgroup, post to ‘net.general’ or for a 
new local newsgroup, post to ‘general’. Include another copy to ‘net.news.group’, for exam¬ 
ple: 

mercury% poBtnews 

Subject : Suggested new newsgroup on Celtic Culture and Language 

Newsgroups : net.general, net.news.group 

niercury% 

Other users will follow-up to ‘net.news.group’, giving opinions about whether the suggested 
newsgroup makes sense, should have a different name, etc. 

When agreement is reached and it is established that there is interest in the topic, ask your 
local netnews administrator to create the newsgroup. It can actually be created by any net- 
news administrator anywhere on the net, within the scope of the newsgroup. Once the news- 
group is created and the first article has been posted, the newsgroup is available for all 
interested persons to post to. 


4.11. User Interfaces 

The user interface of a program is the face it presents to the user, that is, what it displays 
and what it allows you to type. Readnews has options allowing you to use different user 
interfaces. These are: 

“C The —c option displays the the entire message, header and body, and 

prompts you at the end of the message. The command options are the same 
as the msgs interface, but it is usually not necessary to use the suffix on 
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the reply, »ave, or followup commands. This interface is called the 
‘/bin/mail’ interface, because it mimics the UNIX program of that name. 

mail The matl interface, available with the —M option, invokes the mail program 

directly, and allows you to read news with the same commands as you read 
mail. This interface may not work on your system - it requires a special ver¬ 
sion of mail with a —T option.) 

• Use your favorite mail system as an interface, including /bin/mail and mail. 

Any mail system with an option to specify an alternative mailbox can be used 
to read news. For example, to use mail without the —M option, type: 

mercury^ readnewB —c "mall —f 

The Shell command in quotes is invoked as a child of readnews. The —f option to mail names 
the alternative mailbox. Readnews puts the news in a temporary file, and gives the name of this 
file to the mailer in place of the There is an important difference when using this kind of 
interface. The mailers do not give any indication of which articles you read and which ones you 
skipped. Readnews assumes you read all the articles, even if you didn’t, and marks them all 
read. By contrast, the —M option uses the —X option to mail, asking mail to tell readnews 
which articles you read. 


4.12, Rules of the Net 

The network news provides a unique method of communication for many people. Some news- 
groups are intended for discussions and some for announcements or queries. Try to keep this in 
mind when posting or responding to an article. If you are unhappy with what some user said, 
send that user mail. Please consider the following guidelines when using USENET and the net¬ 
work news: 
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• Put all items in an appropriate group. 

• Use mail instead of a followup news item. 

• Be careful when preparing articles for submission. 

• Read followups before responding. 

• Use an editor to prepare items for submission. 

• Don’t be rude or abusive. 

• Avoid sarcasm and facetious remarks. 

• Use descriptive titles. 

• Whenever possible, cite references. 

• Make a summary of the original item in followups. 

• In posting summaries of replies, do make a summary. 

• Don’t force people to read the same thing more than once. 

• Be as brief as possible. 

• Follow local customs. 

• Be fair — Remember that the net is a large audience. Be sure of your facts. 

• Mark puzzles. 

• Do not submit items berating violators of these rules. 

Puzzles are questions to which you know the answer. When submitting a puzzle, make it clear 
that you know the answer to prevent others from putting the solution into followup articles and 
to avoid having other people who know the solution from feeling they have to help you find the 
answer. 

Before posting an article, think about where it is going. If you post it to a “net,” newsgroup, it 
goes to the USA, Canada, Europe, and Australia. For articles of local interest, use the inews —n 
newsgroup feature to restrict distribution to certain newsgroups in your local area. 

The net is not intended for advertising. You may provide informative announcements or profes¬ 
sional products or services on USENET, but they should be of benefit to everyone on the net. 
Mark your announcement as such in the subject. Post the announcement to the appropriate 
newsgroup, never a general-purpose newsgroup such as net.general. Never repeat such an 
announcement and submit only one article per product. 

Some newsgroups are moderated, such as net.announce. In these groups, you cannot post 
directly, either by convention or because the software prevents it. To post to these newsgroups, 
send mail to the moderator. 

Some newsgroups have special purpose rules. Consider the following newsgroups and rules for 
their use. 

net.announce 

Moderated. No direct postings. Good for short announcements and queries that 
need to reach everyone on the net. To post an important announcement for 
everyone send mail to the net.announce moderator at cbosgdlannounce. 
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net.general Announcements only. No discussions. 

net.general Short announcements an queries that require a wide audience, but are inap¬ 
propriate for net.announce. Results of surveys. No discussions. 

net.followup 

For followups to items in net.general. 
net.misc For discussions that have no other natural location. 

net.wanted For posting queries for help, such as “I want an x.” No discussions. Try to limit 
the distribution to a reasonable geographic area. Not that some institutions have 
rules against using computers for such purposes. 

net.fiame All the rules are off in this newsgroup. Total anarchy prevails. 

net.jokes Clean jokes only. Anything offensive must be encrypted. No discussions. Jokes 
only. Discussions go in net.jokes.d. 

net.movies Don’t post anything that reveals the plot of a movie without marking it “spoiler” 
in the subject. 

net.news Discussion of all aspects of USENET itself, 
net.news.group 

Before you create a new group, submit an item here and to specific groups that 
may share interests with your proposed new group. If after a week or two, you 
have received support for the idea and no serious objections, go ahead and create 
the group. Also create an item in the new group with a distant expiration date 
describing wht the group is about. 

net.sources For useful programs and shell scripts after they are announced in some appropri¬ 
ate place. These programs should be well commented so that people who miss 
the announcement can understand what they do. 

net.test For USENET administrators to test the functioning of the software. Use net.test 
only as a last resort as items posted here go to all machines. Try “mh.test”, 
“test” or “ucb.test” as smaller test group. 

net.women.only 

Men are discouraged from participating and are forbidden from criticizing a topic 
or person in this newsgroup. 


4.13. Frequently Asked Questions 

If you are a newcomer to the USENET, read over the following frequently submitted items. 

• What does UNIX stand for? 

UNIX is not an acronym but a pun on “MULTICS.” MULTICS is a large operating system 
that was being developed at Bell Laboratories about the same time as UNIX was created. 

• What does (nf)” in a news item’s title mean? 

It means that the item was created by “notefiles,” an alternative nctnewt interface. 

• What does “:—) ” mean? 
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This is the net convention for a “smiley face,” indicating that something is being said in 
jest. 

• How do I decrypt jokes in net.jokes? 

The standard cypher used in net.jokes is called rotl3. Each letter is replaced by the 
letter 13 letters farther along in the alphabet, wrapping around at the end of the alphar 
bet. You can create a shell script with the tr (translate) command to do the same thing. 
See tr in the Commands Reference Manual. 

• Where can I get the source for empire or rogue? 

The source for empire and rogue is not available at the request of their authors. 

4.14. List of Newsgroups 

This lists the active newsgroups to help you decide which you want to subscribe to. Note that 
the list is constantly changing; about five new lists are added each month. Check with your net- 
news administrator for a local list. 

There are two basic subcategories of netwide newsgroups: 

1. The ‘net.air group consists of USENET bulletin board newsgroups that are circulated around 
the entire net. 

2. The ‘fa.air group is a set of groups that are connected by gateways to USENET from the 
ARPANET. These groups consist mainly of digests, although there are some bulletin boards. 

Some of the ‘net.all’ and ‘fa.air groups are gatewayed between the networks, that is, items sub¬ 
mitted from the ARPA side to the digest are split up and submitted to the USENET group, while 
articles submitted on the USENET side are bundled up and submitted to the digest. 


4 x 4 ^ 1 ^ Local Newsgroups 

Local groups are kept on the current machine only. Local names can be identified by the lack of 
a prefix, that is, there are no periods in local newsgroup names. 

general News and important announcements to be read by everyone on the local 

machine. This newsgroup is usually mandatory to ensure that important 
announcements reach all users. This newsgroup is usually mandatory. The 
list of mandatory newsgroups varies locally. 


4.14-2> FA Newsgroups 

FA groups are ‘from the ARPANET’ and are mostly copies of mailing lists or ‘digests’ distributed 
on that network. A digest is a collection of mail, much like a newsletter, that is put together by 
an editor and sent out every so often. 

FA groups and their corresponding mailing lists can reach a very large user community, includ¬ 
ing USENET sites on UUCP, Berknet, BLN, and the ARPANET, as well as sites on the ARPANET 
which are not on USENET, who get the news via direct electronic mailing. 

fa.arms-d People worried about nukes. 
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fa.arpa-bboard 

fa,digest-p 

fa.editor-p 

fa.energy 

fa.human-nets 

fa.info-cpm 

fa.info-micro 

fa.info-terms 

fa.info-vax 

fa.poli-sci 

fa.sMovers 

fa.space 

fa.tcp-ip 

fa.telecom 

fa. teletext 

fa.unix-cpm 
fa. works 


Announcements that are posted to all arpanet boards are also fed into this 
newsgroup. 

People who deal with digests. Mostly the people who moderate them. 

Interest group in computer editors, both text and program. 

Topics relating to alternate energy production, conservation, etc. 

A daily moderated digest with discussions of computer-aided human-to-human 
communications. Probably the most widely read ARPANET publication. 

CP/M and other operating systems for micro computers. 

Microprocessor discussions. 

Opinions/queries about what’s a good/bad computer terminal. 

VAX interest group. Seems to be mostly VMS issues, but some hardware dis¬ 
cussions too. 

Political Science discussions digest. 

Science Fiction book/movie reviews, etc. 

Digest containing comments on the space program and outer space in general. 
Digest relating to the TCP and IP network protocols. 

Technical topics relating to telecommunications, especially the telephone sys¬ 
tem. A digest recently spun off from fa.human-nets. 

Teletext discusses all aspects of “esoteric” data systems. This includes 
teletext, viewdata, closed-captioning, and digicasting. 

CPM/UNDC discussions. 

Interest group on personal workstations (e.g. Sun, Apollo, Perq, Xerox Star, 
etc). 


414 $^ Newsgroups 


Net groups are intended to be available to all people on the entire network who read netnews. 
This does not mean they go to every machine, since some machines restrict the volume of news 
that comes in. Net groups reach all of USENET, including USENET sites on the ARPANET, but do 
not reach any sites that are not on USENET. That is, USENET is defined as all sites that receive 
‘net.generaP. 


net.general 
net.applic 
net.auto 
net. auto, vw 
net. aviation 
net.bugs 


Articles to be read by everyone on the whole net. 

Functional programming (applicative) languages. 

Notes of interest to owners of particular cars. Main subgroup is net.auto.vw. 
For owners of Volkswagens. 

Private pilots. 

Bug reports and fixes. Subscribing to ‘net.bugs’ gets all bug reports, but bugs 
are normally posted to one of ‘net.bugs.2bsd’, ‘net.bugs.4bsd’, ‘net.bugs.v7’, or 
‘net.bugs.u3’, for the 2nd and 4th Berkeley Software Distribution, Version 7, 
or UNIX system III, as appropriate. 
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net.chess 

net.columbia 

net.cooks 

net.cycle 

net.eunice 

net.games 

net.ham-radio 

net.jokes 

net.lan 

net.lsi 

net.misc 

net.movies 

net.music 

net.news 


net.oa 

net.periphs 

net.rec 


net.records 

net.rumor 

net.sf-Iovers 

net.sources 

net.space 


Interest group for computer chess. This newsgroup is connected into an 
ARPANET mailing list but appears as a normal newsgroup to USENET, so it is 
called ‘net.chess’ instead of ‘fa.chess’. 

Newswire items and comments on the Space Shuttle, and on the space pro* 
gram in general. 

Food, cooking, cookbooks, and recipes. 

Motorcycle interest group. 

Topics of interest to sites running SRI’s Eunice system, which simulates UNIX 
on VMS. 

Discussion of computer games (of the /usr/games/variety). Subgroups include 
‘net.games.rogue’, ‘net.games.frp’ (for fantasy role playing games,) and 
‘net.games.trivia’. 

Topics of interest to amateur radio operators. 

The latest good joke you’ve heard. 

Local area network interest group. 

Large Scale Integrated Circuit discussions. 

Miscellaneous discussions that start in net.general but are not permanent 
enough for their own newsgroup. 

Movie reviews by members of USENET. 

Computer generated music. 

Discussion of netntws itself. Subgroups discuss or post various aspects of netr 
news, including ‘net.news.b’ for the B version of netnews, ‘net.news.directory’ 
to post all or part of the USENET directory, ‘net.news.group’ for discussions 
about proposed new newsgroups, ‘net.news.map’ to post maps of USENET or 
additions/corrections to previously posted maps, ‘net.news.newsite’ to 
announce a new site, ‘net.news’ itself is used for discussions relating to 
USENET policies and the like, rather than any specific software. 

Office Automation/Word Processing interest group. 

Queries and discussions about particular peripherals. (“Does anyone have a 
driver for a frammis~ll?”) 

Recreational games. This differs from ‘net.sport’ in that ‘net.rec’ discusses 
games where one generally participates, but ‘net.sport’ is for spectator sports, 
‘net.games’ is for computer type games. Subgroups of ‘net.rec’ include 
‘net.rec.bridge’ for contract bridge discussions, ‘net.rec.scuba’ for scuba divers, 
and ‘net.rec.ski’ for skiers. 

Discussions of phonograph records, albums, record stores, etc. 

For posting of rumors. 

For science fiction lovers. 

For posting source code for software distribution. 

Undigested, immediate distribution version of fa.space. 
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net.sport 

net.taxes 
net.test 

net. travel 

net.ucds 

net. Unix- wizards 

net.wines 


Spectator sports. Subgroups include ‘net.sport.basebalP, ‘net.sport.football’, 
and ‘net.sport.hockey’. 

Tax advice and queries. 

Test messages are posted here. Generally this is not interesting to ordinary 
readers. 

Requests, suggestions, and opinions about traveling. 

Circuit drawing system. 

ARPANET mailing list for UNIX Wizards. Anything and everything relating to 
UNIX is discussed here. This list is connected to the ARPANET mailing list but 
appears like a regular ‘net’ newsgroup to USENET. 

Information and recommendations about wines and alcoholic beverages. 
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Glossary 


This glossary lists the most important terms in this introduction to the Sun system. 

. The name of your current directory displayed by the command pwd; also see dirs. 

Usually the first component of the search path contained in the variable path, so 
commands in are found first. At the beginning of a component of a pathname, 
is treated specially and not matched by the filename expansion metacharacters 
and ‘[’ ‘]’ pairs. The character is also used in separating filename components. 

.. Each directory has a file in which is a reference to its parent directory. After 

changing into a directory with cd, you can return to the parent directory by typing 
cd ... Then check the current directory with pwd. 

a.out The default file that contains the executable images that compilers create, 

absolute pathname 

A pathname which begins with a is absolute since it specifies the path of direc- 
tories from the beginning of the entire directory system — called the root directory. 
Pathnames which are not absolute are called relative (see relative pathname). 

access mode 

The protection information for a file, ensuring a degree of privacy and safety for the 
user’s files in a shared system. Access mode details the operations allowed (reading, 
writing, or executing) by the three classes of users (owner, group, and public). Also 
called access privilege. 

alias An alias specifies a shorter or different name for a Sun system command, or a com¬ 
mand transformation to be performed in the Shell. The Shell has an alias command 
that establishes aliases and can show their current values. The command unalias 
removes aliases. 

argument 

Additional information that is passed to a command. The command name and its 
arguments are separated from one another by spaces and/or tabs. Arguments are 
usually used to direct the operation of a command. Thus the command echo a b c 
consists of the command name echo and three argument words ‘a’, ‘b’ and ‘c’. The 
set of arguments after the command name is the argument list of the command. 

background process 

A process that runs unattended in a manner that allows other programs to be ini¬ 
tiated and interacted with while the background process is running. 

base That part of a filename before any character. See also filename and extension. 

bg The bg command causes a suspended job to continue execution in the background. 
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bin A directory containing binaries of programs and Shell scripts to be executed. The 

standard system 6m directories are /6m, containing the most heavily used commands 
and /usr/hin, which contains most other user programs. Programs developed at UC 
Berkeley live in /mr/uch, while locally written programs live in /usr/hcal. Games 
are kept in the directory fusrfgames. You can place binaries in any directory. If 
you wish to execute them often, the name of the directories should be a component of 
the variable path. 

Bourne Shell 

The Shell program used in Version 7 UNIX. Named after its author S. R. Bourne. 

buUt‘‘in A command that the Shell executes directly. Most commands in the Sun system are 
not built into the Shell, but rather exist as files in 6m directories. 

buffer A place where data are stored temporarily. 

C Language 

A general-purpose programming language that is the primary language of the UNIX 
system. 

cat The cat command concatenates a list of specified files on the standard output. 

cd The cd command changes the working directory. With no arguments, cd changes 

your working directory to be your home directory. 

child process 

Each call to ‘fork’ creates a new process called the child of the original parent pro¬ 
cess, Each time you spin off a background job, the Shell executing it is a child of 
your current Shell, A command, or any process, can then spawn more children to 
complete specific portions of the task. A process id is specified in the ps (process 
status) command by PID. See also parent process. 

chsh The chsh command changes the Shell which you use on the Sun system. By default, 
you use the C-Shell which resides in /bin/csh. 

command 

An order directing the system to perform some function. A built-in command is han¬ 
dled internally by the Shell, However, most commands result in the execution of a 
program. 

command name 

When a command is issued, it consists of a command name, which is the first word of 
the command, followed by arguments. The convention is that the first word of a 
command names the function to be performed. 

command file 

An ordinary file that contains Shell commands; usually used when referring to a file 
that contains just one or a few commands. The term Shell program is usually used 
when there are a lot of commands or when the ShelPs facilities for looping and condi¬ 
tional execution are used. 

command interpreter 

A component of an operating system which decodes and executes the commands 
entered by the user. The Sun System command interpreter is called the Shell. 

command name 

The first word of a command. The words following the command name are called 
the arguments. 
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compiler A computer program that translates a text file containing a program written in some 
high level programming language into a machine language output that can be exe¬ 
cuted. The machine language output from a compiler is called the object file. 

component 

The part of a pathname between Y’ characters. A variable which has multiple 
strings as a value is said to have several components; each string is a component of 
the variable. 

concatenate 

To combine several files, one after the other; usually performed with the cat com¬ 
mand. 

context search 

Searching for a body of text in a given file by entering a text pattern you want the 
system to locate. You can perform a context search within the editor or you can per¬ 
form context searches using the grep command. 

continue The built-in command that causes execution of the enclosing foreach or while loop to 
cycle prematurely. Similar to the continue command in the programming language 
C, 

control- Certain special characters called control characters control various functions, such as 
cursor movement or printing functions. They are produced by holding down the 
CTRL key on your terminal and simultaneously pressing another character, much 
like the SHIFT key is used to produce upper-case characters. To produce control-c 
(or *C), hold down the CTRL key while pressing the C key. Usually the Sun system 
shows a caret (") followed by the corresponding letter when you type a control char¬ 
acter. 

core dump 

When a program terminates abnormally, the system places an image of its current 
state in a file named core. This core dump can be examined with the system 
debugger adb or dbx to determine what went wrong with the program. The Shell 
may produce a message of the form ‘Illegal instruction (core dumped)’ where ‘Illegal 
instruction’ is only one of several possible messages. 

cp The cp (copy) program copies the contents of one file into another file. 

cflh The name of the Shell program for the C-Shell. 

.cshrc The file xshrc in your home directory that each Shell reads as it begins execution. It 

is usually used to change the setting of the variable path and to set alias parameters 
which are to take effect globally. 

current directory 

The directory whose files are directly accessible. At any time, there is a current 
directory, whose name you can display by typing the pwd command. 

cwd The cwd variable in the Shell holds the absolute pathname of the current working 

directory. The Shell changes it whenever your current working directory changes, 
and it should not be changed otherwise. 

daemon Continually running processes, such as routed, the route daemon, Ipd, the line printer 
daemon, and rahd, the remote shell daemon, that supervise events and manage sys¬ 
tem resources accordingly. The delivermail daemon, for example, sends mail to the 
correct place when it notices that mail has arrived. 
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date The date command displays the current date and time. 

debugging 

The process of correcting mistakes in programs and Shell scripts. The Shell has 
several options and variables which may be used to aid in Shell debugging. 

LELETE The DELETE or RUBOUT key on a terminal normally sends an INTERRUPT to the 
current job. The workstation default is ''C. 

detached 

A process that continues running in the background after you logout. 

diagnostic 

An error message produced by a program. Most error messages are written to the 
diagnostic output, so diagnostics usually appear on the workstation screen. The diag¬ 
nostic output may be directed away from the workstation. 

directory 

Directories contain files and are used to organize and structure the file system. At 
any time you are in one particular directory whose name can be shown by the com¬ 
mand pwd. The cd command changes you to another directory, and makes the files 
in that directory visible. The directory which you are in when you first log in is your 
home directory. 

directory stack 

The C-Shell saves the names of previous working directories in the directory stack 
when you change your current working directory with the puskd command. To 
display the directory stack use the dirs command, which includes your current work¬ 
ing directory as the first directory name on the left. 

dirs The dirs command displays the C-Shell’s directory stack. 

du Short for ‘disk usage,’ the du command shows the number of disk blocks in all direc¬ 

tories below and including your current working directory. 

echo The echo command displays its arguments. 

EOF An end-of-file is generated by a "D, and whenever a command reads to the end of a 
file which it has been given as input. Commands receiving input from a pipe receive 
an end-of-file when the command sending them input completes. Most commands 
terminate when they receive an EOF. 

erase character 

Erases previously typed characters on the current input line one at a time. The 
default is the.LEL key, which you can reassign with the stty command. 

escape A character ‘ \’ that prevents the special meaning of a metacharacter; it escapes the 
metacharacters from their special meanings. 

/etc/pas8wd 

The file containing the major login information (password, login name, userid 
number, the name of the user’s shell) for each user of the system. The /etcfpasswd 
file consists of a line for each account with fields separated by characters. 

execute permission 

For ordinary files execute permission is an access mode that allows you to execute the 
file. For directory files execute permission is an access mode that allows you to 
search them in the course of resolving a pathname. 
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expansion 

The replacement of strings in the Shell input which contain metacharacters by other 
strings. The replacement of the word by a sorted list of files in the current direc¬ 
tory is a ‘filename expansion.’ Similarly the replacement of the characters ‘!!’ by the 
text of the last command is a ‘history expansion.’ 

extension 

Filenames often consist of a base name and an extension separated by the character 
By convention, groups of related files often share the same root name. Thus if 
prog.c were a C program, the object file for this program would be stored in prog.o. 
Similarly a paper written with the —ms nroff macro package might be stored in 
paper.ms, while a formatted version of this paper might be kept in paper.out and a 
list of spelling errors in paper.errs. 

fg The job control command that runs a background or suspended job in the fore¬ 

ground. 

filename Each file in the Sun system has a name consisting of characters, not including the 
character which is used in pathname building. Most filenames do not begin with 
the character and contain only letters and digits with perhaps a separating the 
base portion of the filename from an extension. 

filename expansion 

Filename expansion (also called filename generation) is the procedure that the Shell 
follows to expand command line words containing metacharacters and ‘p and 

‘1’ into the corresponding list of filenames. You can name all the files in the current 
directory, or all files which have a common root name. Other filename expansion 
mechanisms use the metacharacter to easily name files in other users’ directories. 

file system 

The hierarchical collection of files and file management structures (inodes). 

flag Many Sun system commands accept arguments which are not the names of files or 

other users, but modify the action of the commands. These are referred to as flag 
options or simply options, and by convention consist of one or more letters usually 
preceded by the character Thus the Is (list files) command has an option —s to 
list the sizes of files. 

foreground 

When commands are executing in the normal way such that the Shell is waiting for 
them to finish before prompting for another command, they are said to be foreground 
fobs or running in the foreground. Typing different control characters at the key¬ 
board stops foreground jobs. See also background process. 

The grep command searches through a list of argument files for a specified string. 
Grep scans for regular expressions in the sense of the editors ed and ex. Grep stands 
for ‘global regular expression print.’ 

Several users who are members of the same department, working on the same pro¬ 
ject, or related in some other way. Each system file is associated with a certain 
group, and members of that group have specified privileges for accessing the file. 

The head command shows the first few lines of one or more files. Head also describes 
the part of a pathname before and including the last ‘/’ character. 

header field 

At the beginning of a message, a line that contains information that is part of the 


grep 

group 

head 
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structure of the message. Header fields include to, cc, and subject. 

history The history mechanism of the Shell repeats previous commands, possibly after 
modification to correct typing mistakes or to change the meaning of the command. 
The Shell has a history list where these commands are kept, and a history variable 
which controls how large this list is. 

home directory 

Each user has a Aome directory, which is defined in his entry in the password file, 
fetc/passwd. This is the directory which you are placed in when you first log in. 
The cd command with no arguments takes you back to this directory, whose name is 
recorded in the Shell variable home. You can also access the home directories of 
other users by forming filenames using a filename expansion notation and the charac¬ 
ter 

ignoreeof 

Normally, your Shell will exit, displaying ‘logout’ if you type a "D at a hostname 
prompt. This is the way you usually log off the system. You can set the ignoreeof 
variable if you wish in your .login file and then use the command logout to logout. 
This is useful if you sometimes accidentally type too many "D characters, logging 
yourself off. 

Inode The key internal structure for managing files. Inodes contain all the information per¬ 
taining to the mode, type, owner, and location of a fie. 

input The information that many Sun system commands take from the workstation or files 
and act on. Commands normally read for input from their standard input which is, 
by default, the workstation or terminal. This standard input can be redirected from 
a file using the Shell metanotation character ‘<’. Many commands also read from a 
file specified as argument. Commands placed in pipelines read from the output of the 
previous command in the pipeline. The leftmost command in a pipeline reads from 
the workstation or terminal if you neither redirect its input nor give it a filename to 
use as standard input. Special mechanisms exist for supplying input to commands in 
Shell scripts. 

interrupt 

A signal to a program that is generated by typing "C (or the RUBOUT or.LELETE 
key on some terminals), which causes most programs to stop execution. Certain pro¬ 
grams, such as the Shell and the editors, handle an interrupt in special ways, usually 
by stopping what they are doing and prompting for another command. While execut¬ 
ing another command and waiting for it to finish, the Shell does not listen to inter¬ 
rupts. Typing an interrupt often wakes up the Shell because many commands die 
when interrupted. 

job One or more commands typed on the same input line separated by or V characters 

and run together. Simple commands run by themselves without any ‘j’ or charac¬ 
ters are the simplest jobs. Jobs are classified as foreground, background, or 
suspended. 

job control 

The built-in functions that control the execution of jobs. These functions are 6^, fg, 
stop, and kill. 

job number 

When each job is started it is assigned a small job number, which is displayed next 
to the job in the output of the jobs command. Use this number, preceded by a 
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character, as an argument to job control commands to indicate a specific job. 

jobs The jobs command displays a table showing jobs that are either running in the back¬ 
ground or are suspended. 

kernel The memory resident part of the UNIX operating system, containing all of the sys¬ 
tem functions that are needed immediately and frequently. The kernel supervises the 
I/O transactions, manages and controls the hardware, and schedules the user 
processes for execution. 

kill A command which sends a signal to a job causing it to terminate, 

kill character 

The "U character, used to erase the entire current line. This may be reassigned with 
the stty command. 

.login The file Jogin in your home directory is read by the Shell each time you log in to the 
Sun system, and the commands contained there are executed. A number of com¬ 
mands are usually placed in Aogin^ especially tet commands to the Shell itself. 

login directory 

Same as home directory. 

login Shell 

The Shell that is started on your workstation when you log in. It is different from 
other Shells which you may run (such as on Shell scripts) in that it reads the .login 
file before reading commands from the workstation or terminal, and it reads the 
.logout file after you logout. 

logout The logout command causes a login Shell to exit. Normally, a login shell exits when 
you type "D generating an end-of-file, but if you have set ignoreeof xn your .login file, 
this will not work and you must use logout to log off the Sun system. 

.logout When you log off the Sun system, the Shell executes commands from the file .logout 
in your home directory after it displays ‘logout,’ 

Ipr The line printer daemon command. The standard input of Ipr is spooled and printed 

on the line printer. You can also give Ipr a list of filenames as arguments to be 
printed. 

Is With no argument filenames, the Is command shows the names of the files in the 

current directory. It has a number of useful flag arguments, and can also be given 
the names of directories as arguments, in which case it lists the names of the files in 
these directories. 

macro package 

A set of high level nroffitroff text formatting requests for more convenient text pro¬ 
cessing functions. 

mail The mail transmits memos, messages, and letters to other users of the same system 
and to users on other systems. 

mailbox The place where your mail is stored, typically in the directory lusrf opooljmail. 
message A single letter from someone, initially stored in your mailbox. 

message list 

A string used in mail command mode to describe a sequence of messages. 
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metacharacter 

The characters that are neither letters nor digits that have special meaning either to 
the Shell or to the Sun system. Enclose them in quotes if it is necessary to place 
these characters in arguments to commands without them having their special mean¬ 
ing. An example of a metacharacter is the character ‘>’ which indicates placement 
of output into a file. For the purposes of the history mechanism, most unquoted 
metacharacters form separate words. 

mkdir The mkdir command creates a new directory. 

modifier 

Substitutions with the history mechanism, keyed by the character or by variables 
using the metacharacter are often subjected to modifications, indicated by placing 
the character after the substitution and following this with the modifier itself. 

more The more program shows a file on your workstation and allows you to control how 
much text is displayed at a time. More can move through the file screenful by 
screenful, line by line, search forward for a string, or start again at the beginning of 
the file. 

noclobber 

The Shell variable that prevents accidental destruction of files by the ‘>’ output 
redirection metasyntax of the Shell if set in the file Aogin. 

noglob The Shell variable that suppresses the filename expansion of arguments containing 
the metacharacters ‘[’ and 

notify The notify variable tells the Shell to report on the termination of a specific back¬ 
ground job at the exact time it occurs as opposed to waiting until just before the 
next prompt to report the termination. If set, the notify variable causes the Shell to 
always report the termination of background jobs exactly when they occur. 

object file 

A file containing machine language that can be executed by the workstation. An 
object file is the result of a compilation. 

ordin&ry file 

Used for storing data in the form of programs, documents, letters data bases, and 
other types of information. 

output The lines of text resulting from many Sun system commands. This output is usually 
placed on what is known as the standard output, which is normally connected to the 
user’s workstation. The Shell has a syntax using the metacharacter ‘>’ for redirect¬ 
ing the standard output of a command to a file. Using the pipe mechanism and the 
metacharacter ‘j’ it is also possible for the standard output of one command to 
become the standard input of another command. Certain commands such as the line 
printer daemon Ipr do not place their results on the standard output but rather on 
the line printer. Similarly the write command places its output on another user’s 
workstation rather than its own standard output. Commands also have a diagnostic 
output where they write their error messages. Normally these go to the workstation 
even if the standard output has been sent to a file or another command, but it is pos¬ 
sible to direct error diagnostics along with standard output using a special notation. 

parent process 

A process from which other processes called children are run. Parents can run simul¬ 
taneously with their children, or can wait for the children to ‘die’ before proceeding. 
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depending on the task. Specified as PPID, the parent process id number, by the ps 
(process status) command. See also chiid process. 

path The Shell variable that gives the names of the directories in which it searches for the 
commands which it is given. Path always checks first to see if the command it is 
given is built into the Shell. If it is, then it need not search for the command as it 
can do it internally. If the command is not built in, the Shell searches for a file with 
the name given in each of the directories in the path variable, left to right. Since the 
normal definition of the path variable is lusr/xtcb /bin /usr/bin, the Shell normally 
looks in the current directory, and then in the standard system directories /usr/ucb, 
/bin and /usr/bin for the named command. If the command cannot be found the 
Shell displays an error diagnostic. Scripts of Shell commands are executed using 
another Shell to interpret them if they have ‘execute’ permission set. If you add new 
commands to a directory in the path, use the command rehash. 

pathname 

A path through the file system that leads to a file. It is formed by listing directory 
names separated by slashes (/’s) to define the path. Each component of a pathname, 
between successive ‘/’ characters, names a directory in which the next component file 
resides. Pathnames which begin with the character ‘/’ are interpreted relative to the 
root directory in the filesystem. Other pathnames are interpreted relative to the 
current directory as reported by pwd. The last component of a pathname may name 
a directory, but usually names a file, 

permissions 

The access modes associated with a file. See access mode. 

pipe A connection between the standard output of one program and the standard input of 
another program. The Shell metacharacter ‘j’ indicates the pipe mechanism. 

pipeline 

A group of commands connected together, the standard output of each being con¬ 
nected to the standard input of the next. 

popd The popd command changes the Shell’s working directory to the directory you most 
recently left using the pushd command. It returns to the directory without having to 
type its name, forgetting the name of the current working directory before doing so. 

port The part of a computer system to which each terminal is connected is called a port. 

Usually the system has a fixed number of ports, some of which are connected to tele¬ 
phone lines for dial-up access, and some of which are permanently wired directly to 
specific terminals. 

pr The pr command prepares listings of the contents of files with headers giving the 

name of the file and the date and time at which the file was last modified. 

printenv 

The printenv command displays the current setting of variables in the environment. 

process A program that is being executed; an entry in the system’s process table. The sys¬ 
tem assigns each process a unique process id number (PID) when it is started. Use 
process id numbers to stop individual processes with the kill or slop commands when 
the processes are part of a detached background job. See also child and parent pro¬ 
cess. 

program Usually synonymous with command; a binary file or Shell command script that per¬ 
forms a useful function. 
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prompt The indication by a program on the screen that it is ready to accept input. The 
Shell prompts for input with ‘hostname% ’ and occasionally with when reading 
commands from the workstation. The Shell has a variable prompt which may be set 
to a different value to change the Shell’s main prompt. This is mostly used when 
debugging the Shell. 

ps The ps command shows processes you are currently running, each process being 

listed with its unique process number, an indication of the terminal name it is 
attached to, an indication of the state of the process (whether it is running, stopped, 
awaiting some event (sleeping), or whether it is swapped out), and the amount of 
CPU time it has used so far. A command is identified by listing some of the words 
used when it was invoked. Shells, such as the csk you use to run the ps command, 
are not normally shown in the output. 

pushd The pushd command, which means ‘push directory’, changes the Shell’s working 
directory and also remembers the current working directory before the change is 
made, so you can return to the same directory with the popd command later without 
retyping its name. 

pwd The pwd command displays the full pathname of the current working directory, simi¬ 
lar to the dirs built-in command. 

quit The signal generated by a control-\ ("\), that terminates programs which are behav¬ 
ing unreasonably. Quit normally produces a core image file. 

quoting The process by which metacharacters are prevented from having their special mean¬ 
ing, usually by using the character ‘’ in pairs, or by using the character 

read permission 

Allows a person to execute a program that reads data from a file, 

redirection 

The Shell’s reassigning of standard input to a file other than the workstation and of 
reassigning the standard output to a specified file. 

regular expression 

A regular expression specifies a set of strings of characters. 

rehash The rehash command tells the Shell to rebuild its internal table of which commands 
are found in which directories in your path. This is necessary when a new program is 
installed in one of these directories. 

relative pathname 

A pathname that does not begin with a ‘/’ since it is interpreted relative to the 
current working directory. The first component of such a pathname refers to some 
file or directory in the working directory, and subsequent components between 
characters refer to directories below the working directory. See also absolute pofA- 
names. 

repeat The repeat command iterates another command a specified number of times. 

root The directory that is at the top of the entire directory structure; it is the ‘root’ of 

the entire tree structure of directories. The ‘/’ indicates the root name in path¬ 
names. Pathnames starting with ‘/’ are absolute since they start at the root direc¬ 
tory. Root is also used as the part of a pathname that is left after removing the 
extension. See filename for a further explanation. 
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scratch file 

Files whose names begin with a and are automatically removed by the system 
after a couple of days of non-use, or more frequently if disk space becomes tight. 

set The built-in command that assigns new values to Shell variables and when used by 

itself shows the values of the current variables. Many Shell variables have special 
meaning to the Shell itself, so using the set command can affect the behavior of the 
Shell. 

setenv The built-in command that changes variables in the environment ‘environ’. The 
printenv command displays the value of the variables in the environment, 

shell A command language interpreter. It is possible to write and run your own Shell, as 
Shells are no different than any other programs as far as the system is concerned, 

shell program 

A program written using the Shell programming language. Shell programs can be 
written and executed interactively, although most Shell programs are stored in ordi¬ 
nary files. 

signal A short message that is sent to a running program which affects that process. Signals 
are sent either by typing special control characters on the keyboard or by using the 
kill or stop commands. 

sort The sort program sorts a sequence of lines in ways that you can control with argu¬ 
ment flags. 

source The source command reads commands from a specified file. It is most useful for 
reading files such as .cshrc after changing them. 

special character 

See metacharacters. 

special file 

Files that provide an interface to I/O devices. 

standard I/O 

Many programs need to read commands and data from the user, write messages to 
the user, and write error messages. Therefore, the Shell prepares three standard I/O 
connections for each program, the standard input, the standard output, and the stan¬ 
dard error. The standard channels are usually connected to the user’s workstation 
although they can be reassigned using redirection. 

status A command normally returns a status when it finishes. By convention a status of 
zero indicates that the command succeeded. Commands may return non-zero status 
to indicate that some abnormal event has occurred. The Shell variable status is set 
to the status returned by the last command. It is most useful in Shell command 
scripts. 

stop The stop command suspends a background job. 

string A sequential group of characters taken together. Strings can contain any printable 
characters. 

stty The stty program changes certain parameters inside the Sun system to determine 
how your workstation or terminal is handled. See stty in the Commands Reference 
Manual for a complete description. 
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subdirectory 

A directory below another directory in the file system hierarchy. 

substitution 

The Shell implements a number of substitutions where sequences indicated by metar 
characters are replaced by other sequences. Notable examples of this are history 
substitution keyed by the metacharacter M’ and variable substitution indicated by 
We also refer to substitutions as expansions. 

superuser 

A special privilege level that exists to allow system managers to perform certain func¬ 
tions that are denied to ordinary users. The superuser is not constrained by the nor¬ 
mal file access mode system, 

suspended 

A job becomes suspended after a STOP signal is sent to it, either by typing a (for 
foreground jobs) or by using the stop command (for background jobs). When 
suspended, a job temporarily stops running until it is restarted by either the fg or bg 
command. 

system call 

A request by an active process for a service by the kernel. System calls perform I/O, 
control, coordinate, and create processes, and read and set various status elements of 
the system. 

termination 

Occurs when a command which is being executed finishes. Commands normally ter¬ 
minate when they read an end-of-file from their standard input. It is also possible to 
terminate commands by sending them an interrupt or quit signal. The kill program 
terminates specified jobs, 

time The time command measures the amount of CPU and real time used by a specified 
command as well as the amount of disk I/O, memory utilized, and number of page 
faults and swaps taken by the command. 

tset The tset program sets standard erase and kill characters and tells the system what 

kind of terminal you are using. It is often invoked in a .login file. 

tty The historical abbreviation for ‘teletype’ which is frequently used in the Sun system 

to indicate the port to which a given workstation is connected. The tty command 
displays the name of the tty or port to which your workstation or terminal is 
presently connected. 

unalias The unalias command removes aliases. 

UNIX The operating system on which the Sun system is based, 
unset The unset command removes the definitions of Shell variables. 

variable expansion 

See variables and expansion. 

variables 

Contain one or more strings as value and control the behavior of the Shell. 

verbose A Shell variable that echoes commands after they are expanded by the history 
mechanism. This is often useful in debugging Shell scripts. The verbose variable is 
set by the Shell’s —v command line option. 
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wc The wc (word count) command counts the number of characters, words, and lines in 

the files whose names are given as arguments. 

word A sequence of characters which forms an argument to a command. Many characters 
which are neither letters, digits, ‘nor ‘/’ form words all by themselves even if 
they are not surrounded by blanks. Any sequence of characters may be made into a 
word by surrounding it with ’ characters except for the characters ’and ‘!’ 
which require special treatment. This process of placing special characters in words 
without their special meaning is called quoting. 

working directory 

The particular directory you are in at any given time. Pwd displays this directory’s 
name and Is lists its files. You can change working directories using cd. 

write The write command communicates with other users who are logged in to the system. 

write permission 

Allows a user’s programs to write data to a file. 
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